mirror of
https://github.com/vegu-ai/talemate.git
synced 2026-10-28 17:45:06 +00:00
7db12b042b
- **Scene Revisions** — Revision history with one row per message, date filter and text search; fork a new save from any past revision. Replaces the Timeline, which never worked reliably. - **Character Knowledge** — Characters only remember passages they witnessed and information shared with them. Known by, Learn and Never Learn controls, also available to the Director. - **Character Perspectives** — Optional mode that keeps each character's own account of events and uses it for their memories and summaries. Accounts can be read and edited beside the full story. Needs a strong model and adds analysis requests. - **Decision Model** — Optional small model (OpenRouter or a SystemOne-compatible server) that answers yes/no questions with a probability: pin conditions, skipping unchanged tracked states, portrait and background picks, Editor checks. Includes a Decision Log. - **Themes** — Light and dark themes, custom themes (colors, message styling, editor appearance) with a live preview - **Replay** — Step through a story one passage at a time with optional narration, auto-advance and chapter navigation; fork from any passage. - **Scene Controls** — Configurable scene header, reusable scene tool shortcuts, and game variables pinned as sliders, choices or toggles. - **Scene Backgrounds** — The World State agent can pick or generate a scene backdrop that fits the story; backdrop changes are recorded in the history. Off by default. - **Help Chat** — The Help agent can create and change themes and templates, adjust settings and edit inference presets, each behind a permission that is off by default. - **Chatterbox Turbo** — New optional voice backend with voice cloning and sound tags. Plus 35 improvements and 35 bug fixes — see [CHANGELOG.md](https://github.com/vegu-ai/talemate/blob/prep-0.40.0/CHANGELOG.md#0400) for the full list. |
||
|---|---|---|
| .github/workflows | ||
| docs | ||
| examples | ||
| install-utils | ||
| scenes | ||
| src/talemate | ||
| talemate_frontend | ||
| templates | ||
| tests | ||
| tts/voice | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .python-version | ||
| CHANGELOG.md | ||
| CHANGELOG.yaml | ||
| config.example.yaml | ||
| CONTRIBUTING.md | ||
| docker-compose.cpu.yml | ||
| docker-compose.manual.yml | ||
| docker-compose.yml | ||
| docker-entrypoint.sh | ||
| Dockerfile | ||
| frontend_wsgi.py | ||
| install-cuda.bat | ||
| install-cuda.sh | ||
| install-ffmpeg.bat | ||
| install.bat | ||
| install.sh | ||
| LICENSE | ||
| mkdocs.yml | ||
| pyproject.toml | ||
| README.md | ||
| ruff.toml | ||
| start-backend.bat | ||
| start-backend.sh | ||
| start-debug.bat | ||
| start-frontend.bat | ||
| start-frontend.sh | ||
| start-local.bat | ||
| start.bat | ||
| start.sh | ||
| update.bat | ||
| update.sh | ||
| uv.lock | ||
Talemate
Roleplay with AI, with a focus on narration and consistent world and game state tracking.
 |
 |
|---|---|
 |
 |
Core Features
- Agents for dialogue, narration, summarization, scene direction, editing, world state tracking, character and scenario creation, text-to-speech, image generation, and answering questions about Talemate itself
- A separate client and model per agent, with optional per-scene agent settings
- Long-term memory, layered history summaries and tracking of the passage of time
- Tracked character and world states, pins and game state variables that are kept in the AI's context
- Character knowledge: characters know only the passages they were present for and the information shared with them, with Learn / Never Learn rules for exceptions
- Character perspectives (optional mode): each character keeps their own account of events, used for their memories and summaries and readable beside the story
- Decision model (optional): a small model answers questions about the story with a probability, so other agents can skip or choose without a full request; every answer is listed in a Decision Log
- Director chat to query and change the scene in conversation, and optional autonomous scene direction
- World editor for characters, world entries, history, pins and the context database, with AI-assisted character and scenario creation from templates and character card import
- Image generation for character portraits, scene illustrations and backdrops, managed in a visual library
- Text-to-speech with per-character voices and several local and remote backends
- Node editor for scene logic and reusable modules
- Scene revisions to browse saved states per message and fork a new save from any of them, and replay to step through a story one passage at a time
- Prompt manager: every prompt is a Jinja2 template that can be overridden
- Themes: light and dark themes, and your own themes edited with a live preview
- Help agent that answers questions about Talemate from the bundled documentation and, with your permission, changes settings, themes and templates
Documentation
- Installation and Getting started
- Model expectations - what Talemate needs from your model
- User Guide
Discord Community
Need help? Join the Discord community
Supported APIs
- OpenAI
- Anthropic
- Google Gemini (Gemini API key or Vertex AI)
- mistral.ai
- Cohere
- Groq
- DeepSeek
- OpenRouter
Supported self-hosted APIs:
- llama.cpp (
llama-server) - KoboldCpp (Local, Runpod, VastAI, also includes image gen support)
- oobabooga/text-generation-webui (local or with runpod support)
- LMStudio
- TabbyAPI
- Ollama
Other clients:
- OpenAI compatible - any server with an OpenAI-style completions or chat completions API, for example DeepInfra
- Pi Bridge - runs generations through the pi coding agent, which handles provider authentication and model selection