Roleplay & chat frontends

RisuAI

Local-first roleplay client with deep prompt control.

RisuAI keeps your character data local and lets you point at any OpenAI-compatible chat completions URL. Use the full FreeTheAi /chat/completions URL and any alias.

Base URL https://api.freetheai.xyz/v1
API path /chat/completions
Recommended models bbg/zai-org/GLM-5.1
Chat completions Streaming
Get a free key GitHub repo Visit RisuAI
Step by step

Connect RisuAI to FreeTheAi.

  1. 1

    Open Risu settings

    In Risu, open the three-dot menu and go to settings. Pick the `AI Model & API` section.

  2. 2

    Pick OpenAI Compatible

    Set the model source to `OpenAI` or `OpenAI Compatible`. Uncheck `Auto-fill request URL` so Risu does not rewrite your endpoint.

  3. 3

    Fill the request URL and key

    Risu sends the full URL verbatim, so include `/chat/completions`.

    text 
    Request URL: https://api.freetheai.xyz/v1/chat/completions
API Key: PASTE_YOUR_FREETHEAI_KEY
  4. 4

    Type a FreeTheAi alias

    Type any alias from /models in the model field. Risu forwards it as the `model` value.

    text 
    bbg/zai-org/GLM-5.1
Recommended aliases

Models that pair well with RisuAI.

  • bbg/zai-org/GLM-5.1
  • rev/claude-sonnet-4.5
  • wsf/kimi-k2.6

See the full live catalog at /models. Aliases are stable; pricing on the free tier stays $0.

Heads up

Common gotchas.

  • Risu does not auto-add `/chat/completions`. Paste the full path or every request will 404.
  • Risu's roleplay prompts are long. Pair it with `bbg/*` or `wsf/*` aliases that have a generous context window.
  • Avoid `cat/*` and `yng/*` for roleplay - they do not handle Risu's tool/system shape well.
Where to next

Keep building.

All setup guides Quickstart Cross-compatibility docs Model catalog Ask in Discord