โ ๏ธ Serene Pub is in alpha! Expect bugs and rapid changes. This project is under heavy development.
๐ Documentation โข โฌ๏ธ Downloads โข ๐ Issues โข ๐ฌ Discord โข โ Buy Me a Coffee
Modern, Open Source AI Roleplay Chat
Serene Pub is a brand new, open source chat application for immersive AI roleplay and creative conversations. Designed for simplicity, speed, and beautiful usability, Serene Pub brings your characters and worlds to lifeโon your terms, with your data, and your favorite AI models.
For detailed installation instructions, configuration guides, and tutorials, visit our Wiki.
- Zero Clutter, Maximum Fun: Clean, intuitive UI with minimal menus and instant access to everything you need.
- Real-Time Sync: All chats, settings, and characters update live across devices via WebSockets.
- Portable & Private: Runs locally, no accounts, no cloud lock-in. Your data stays with you.
- AI Freedom: Connect to OpenAI, Ollama, LM Studio, Llama.cpp, and more. Mix and match models, run local or cloud.
- Low fuss local AI: Use Ollama manager to search, download and activate models all within the comfort of Serene Pub.
- Roleplay-First: Built for character-driven, story-rich experiences. Import Silly Tavern cards, manage personas, and more.
- Coherence: Some user's report characters adhere better to their profiles than other apps.
- Group Chats: Chat with as many characters at once as you wish.
- Mobile Ready: Responsive design for desktop and mobile. Pick up your story anywhere.
- Open Source: AGPL-3.0. Hack it, extend it, make it yours!
| Chat & Editing | Connections & Characters | Contexts & Lorebooks |
|---|---|---|
| Prompt Details | Prompts & Chats | Sampling & Personas |
|---|---|---|
| Theme Example 1 | Theme Example 2 | Theme Example 3 |
|---|---|---|
| Theme Example 4 | Theme Example 5 |
|---|---|
| Character Bindings | Character Lore | Lorebook History | World Lore |
|---|---|---|---|
| Available Models | Downloads | Installed Models | Settings |
|---|---|---|---|
| Chat | Connections | Edit Character |
|---|---|---|
| Home | Navigation |
|---|---|
- AI Model Agnostic: Connect to OpenAI, Ollama, Llama.cpp, and more
- Ollama Manager: Built-in UI to easily manage, download, and activate Ollama models
- Character & Persona Management: Import, create, and edit with rich metadata and avatars
- Lorebooks+: Organize world lore, character lore, and history for deep roleplay
- Group Chats: Multi-character chats for immersive group roleplay and dynamic storylines
- Tags: Easily organize and filter chats, characters, personas, and lorebooks with customizable tags
- Chat & Context Tools:
- Auto character response
- Edit/delete messages
- Streaming & regenerate
- Manual & hidden responses
- Swipe left/right on messages
- Live token and history stats
- Prompt Statistics: View compiled prompts before sending
- Context Templates: Handlebar-based, customizable prompt formats
- Mobile-First Design: Fully responsive, works great on phones and tablets
- Themes & Dark Mode: 20+ themes, instant switching, and accessibility options
- Accessibility & Screen Reader Support: Experimental support for screen readers and assistive technologies (in progress)
- Portable & Secure: Embedded database, no cloud required, runs anywhere
- Silly Tavern Compatibility: Import/export character cards and avatars
- Open Source & Extensible: AGPL-3.0, modular adapters, easy to hack
Linux, MacOS and Windows are supported!
- Download the latest release for your OS
- Extract the archive anywhere
- Read the included
INSTRUCTIONS.txtfor your platform - Run the launcher script (
run.sh/run.cmd) - Open http://localhost:3000 in your browser
- Add your first AI connection and start chatting!
- Clone this repo
npm ito install dependenciesnpm run devto start the dev server, ornpm run dev:host- Visit http://localhost:5173
Need help? Check out our Setup Guide in the wiki.
Popular Wiki Pages:
- Installation & Setup - Detailed setup instructions for all platforms
- Connections - How to connect to AI models (OpenAI, Ollama, LM Studio, etc.)
- Characters & Personas - Creating and managing your roleplay characters
- Lorebooks - Advanced world-building and context management
- Context Templates - Customizing AI prompts with Handlebars
- Troubleshooting - Common issues and solutions
- ๐ง Vectorization / embeddings
- ๐ค Assistant Chat: Ask AI questions about Serene Pub and get suggestions to improve your characters, personas, and lore
- ๐ค Assistant Chat: In-chat OOC discussions
- ๐ผ๏ธ Image generation
- ๐ Chat summarizing
- ๐ฅ Multi-user logins & multi-user group chats
- ๐ฅ Admin user account management
- ๐ผ๏ธ User/chat backgrounds
- ๐ Story narration/system instructions
- ๐ Lorebooks+ features: custom calendars, "eras" historical categories, and more
- ๐น๏ธ Text adventure & narrator modes
Serene Pub is community-driven! Bug fixes, features, and feedback are welcome. Please open an issue or start a discussion before submitting large changes.
For development setup and contribution guidelines, see our Contributing Guide.
AGPL-3.0. See LICENSE and NOTICE.md for details.
Special thanks to crazyaphro and Nivelle for Q/A, M3d4r for editing the Wiki, and .
Serene Pub โ Play more, tweak less. 100% open source.
๐ Read the full documentation