The world is vast, let imagination lead, but human hearts remain forever inscrutable
世界广阔无垠,让想象力引领前行,但人心永远不可直视
Important
- 本项目仅供个人学习使用,且不提供任何技术支持
- 使用者必须在遵循 OpenAI 等模型服务商的使用条款以及法律法规的情况下使用,不得用于非法用途
- 根据《生成式人工智能服务管理暂行办法》的要求,请勿对中国地区公��提供一切未经备案的生成式人工智能服务
Caution
- Narratium.ai 为纯粹的开源社区项目,仅供研究与个人学习。
- 未经作者及贡献者的书面许可,任何个人或组织不得将本项目用于商业化、变现或提供衍生商业服务。
- 因使用、部署或运营本项目产生的一切责任、合规义务及法律风险,均由使用者自行承担,与作者、贡献者及维护者无任何关联或连带责任。
An open-source AI character platform to build, customize, and chat with virtual personas
For writers, developers, and storytellers building interactive worlds
| What is Narratium |
|---|
Narratium.ai is an open-source platform for creating AI characters, immersive worlds, and dynamic conversations.It's your creative studio for building personalized roleplay adventures — from emotional journeys to epic sagas.
| Experience & Play |
|---|
| Version Information |
|---|
- main: Stable version branch, regularly builds desktop versions through pake.
- dev: Development version branch, with multiple commits daily.
| Quickly Start |
|---|
For detailed installation and setup instructions, please refer to our Getting Started Guide.
For detailed Vercel deployment instructions, please refer to the Vercel Deployment Guide.
For Download Version: please refer to the Download for Mac, Windows, Linux.
| Features |
|---|
- Immersive Adventure Mode: Create personalized worlds and make decisions that matter.
- Visual Memory Management: React Flow-powered session tracing and branching.
- Character Cards & Lore: Compatible with SillyTavern cards, manage everything in one place.
- Powerful Plugin System: Supports a rich plugin ecosystem, extensible features, and custom UI components. See Plugin Development Guide for details.
| API Recommendations & Configuration |
|---|
Recommended API Services:
- OpenAI: Directly supports models using the OpenAI API format.
- OpenRouter: Recommended to use OpenRouter for unified access to various models.
- Relay Service Deployment: Recommended new-api.
- Local Deployment: Supports local inference services like Ollama, LM Studio, etc.
| Narratium vs. Other AI Roleplay Platforms |
|---|
| Feature | Narratium.ai | SillyTavern | AI Dungeon | fount |
|---|---|---|---|---|
| Open Source | ✅ | ✅ | ❌ | ❌ |
| Beginner Friendly | ✅ | ❌ (complex setup) | ✅ (but limited flow) | ❌ |
| Character Memory & Tracking | ✅ | ❌ | ❌ | |
| Worldbook Support | ✅ | ❌ | ❌ | |
| Long-term Conversation Support | ✅ | ✅ | ❌ (limited context) | ❌ |
| Offline / Local Deployment | ✅ | ✅ | ❌ | ❌ |
| Visual Interface / UI Polish | ✅ | ❌ (minimal) | ✅ | ❌ |
| Infinite Branching Storylines | ✅ | ✅ (but unstable) | ❌ |
| License Overview |
|---|
This project consists of two distinct parts with independent licenses:
- 🔐 Code: AGPL-3.0 License — copyleft license requiring source code disclosure for network services, with mandatory GitHub attribution.
- 🔒 Content: CC BY-NC-SA 4.0 — non-commercial use only, with attribution and same-license sharing required.
- 🌐 Web Deployment: Must display visible link to https://github.com/Narratium/Narratium.ai
For full license details, please refer to the LICENSE.
| Code Contributer |
|---|
| Others |
|---|
Thanks all Official Website Test API Sponsor
| Star Growth |
|---|


