Narratium.ai

Create, Play, and Roleplay with AI

The world is vast, let imagination lead, but human hearts remain forever inscrutable
世界广阔无垠，让想象力引领前行，但人心永远不可直视

Important

• 本项目仅供个人学习使用，且不提供任何技术支持
• 商业化请参考 License 或进入社区咨询作者
• 使用者必须在遵循 OpenAI 等模型服务商的使用条款以及法律法规的情况下使用，不得用于非法用途
• 根据《生成式人工智能服务管理暂行办法》的要求，请勿对中国地区公众提供一切未经备案的生成式人工智能服务

An open-source AI character platform to build, customize, and chat with virtual personas
For writers, developers, and storytellers building interactive worlds

🔗 Live Demo  |  📖 DeepWiki Docs  |  💬 Discord Community  |  💾 Download  |  🇨🇳 中文文档

Characters, worlds, and conversations — beautifully unified in Narratium

Getting started & staying tuned with us

Star us, and you will receive all release notifications from GitHub without any delay!

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

Official Service (Free registration required)  |  🧪 Open Source Preview

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	✅	⚠️ (plugin-based)	❌	❌
Worldbook Support	✅	⚠️ (via extensions)	❌	❌
Long-term Conversation Support	✅	✅	❌ (limited context)	❌
Offline / Local Deployment	✅	✅	❌	❌
Visual Interface / UI Polish	✅	❌ (minimal)	✅	❌
Infinite Branching Storylines	✅	⚠️ (manual effort)	✅ (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.

Contact & Support

• 如果你喜欢这个项目，我们非常欢迎你加入
• If you like this project, we warmly welcome you to join us

官方 QQ 用户群

Discord 技术社区

Code Contributer

Others

Thanks all Official Website Test API Sponsor

Star Growth