Connection
Point the app at your story server. After saving, refresh the main stage tab if it was already open.
Story server URL
Host only — for example https://yourdomain.com when nginx proxies /api/, or http://127.0.0.1:3847 for local dev. Do not include /api/....
Settings are stored in data/settings.sqlite on the story server.
Learner
Characters, chat, stories, and voice tutor replies are phrased for this age. Default is 10 until you save.
Whole number from 3 to 100.
Cloud AI
API keys and cloud preferences. Turn Offline AI off (in the Offline tab) to use these when keys are saved.
OpenAI
Used for OpenAI chat, TTS, cloud Whisper, and AI image generation. Required for generated backgrounds and props. On a hosted server you can also set OPENAI_API_KEY in the API .env file instead of saving here.
How to get an OpenAI API key (for grown-ups)
- Go to platform.openai.com and sign in, or create an account.
- Add billing if OpenAI asks — API use is pay-as-you-go. See pricing.
- Open API keys and click Create new secret key.
- Name it (for example Qanvaz), copy the key (starts with
sk-), and paste it below. - Click Save OpenAI key. Keep the key private — never share it online.
Kids: ask a trusted grown-up to do these steps for you.
Cloud chat & speech
Use OpenRouter for flexible models, or OpenAI directly. Kokoro runs speech on your story server (no OpenAI TTS charges).
Example: openai/gpt-4o-mini
Offline AI
Default is On. Story, chat, tutor, and speech run locally with Whisper, Kokoro, and Ollama or an embedded .gguf. Switch Off to use cloud APIs when keys are configured.
AI mode
Ollama
Exact tag from ollama list / ollama pull.