Your AI-Powered Dungeon Master Assistant
Storyteller is a CLI-based application that uses Large Language Models (LLMs) to run tabletop roleplaying games. It manages lore, tracks story state, and acts as an immersive Dungeon Master.
- Multi-Provider AI: Support for OpenAI, Anthropic, and Gemini.
- Lore Management: Local Markdown-based lore system with smart retrieval.
- Persistence: SQLite database for saving stories, characters, and events.
- MCP Support:
- Server: Expose Storyteller tools to Claude Desktop.
- Client: Connect Storyteller to external tools (Web Search, etc.).
| Topic | Description |
|---|---|
| Setup Guide | Installation, API keys, and initialization. |
| PyPI Installation | Installing and using from PyPI. |
| GitHub & Template Guide | Cloning, setup, and creating custom distributions. |
| Database Guide | Understanding the schema and managing save files. |
| RAG & Vector Search | How the AI remembers lore using vector embeddings. |
| Procedural Tools | Generating dungeons and loot. |
| Export & Sharing | Exporting stories and packing lore. |
| Plugin System | Extending Storyteller with Python scripts. |
| Textual TUI | Using the rich terminal interface. |
| Publishing Guide | Packaging and distributing the library. |
| Quick Start | Basic usage instructions. |
| Chat Interface | Deep dive into how to play and interact. |
| CLI Reference | Complete command list (start, serve, dm-assist). |
| Lore Guide | How to write and organize your world's lore. |
| MCP Integration | Configuring MCP Server and Client modes. |
| Best Practices | Tips for better prompting and game management. |
| Architecture | System design and component overview. |
- Install: ```bash pip install ai-storyteller-cli
pip install "ai-storyteller-cli[rag]"
2. **Configure**: Create `.env` with API keys.
3. **Init**: `storyteller init`
4. **Play**: `storyteller start`
## License
MIT