xiamuceer-j/MuMuAINovel

What is it?

Key features

• 01Generates outlines, characters and worldbuilding with AI through a guided wizard.
• 02Creates, edits, regenerates and polishes chapters.
• 03Visualizes character relationships and organization structures.
• 04Supports OpenAI, Gemini, Claude and OpenAI-compatible relay APIs.
• 05Offers local account login or LinuxDO OAuth, with per-user data isolation.
• 06Deploys with Docker Compose on PostgreSQL.

Use cases

• Drafting a novel's outline, cast and setting before writing chapters.
• Managing a multi-book project with many characters and factions.
• Running a shared self-hosted writing tool for a small group of authors.

Quick start

1. 1

   Clone the repository

   git clone https://github.com/xiamuceer-j/MuMuAINovel.git
2. 2

   Create the .env configuration file from the example and fill in your API keys and database password

   cp backend/.env.example .env
3. 3

   Start the services with Docker Compose

   docker-compose up -d
4. 4

   Open http://localhost:8000 in your browser

Things to know

• !You need an API key from at least one paid AI provider such as OpenAI, Gemini or Claude.
• !Building from source requires an embedding model of about 400 MB that is not published openly and must be obtained through the project's community channels.
• !The project is licensed under GPL-3.0, which is copyleft and requires derivative works to be open source under the same license.
• !The README and main community channels are in Chinese.

Topics

FAQ

What is MuMuAINovel?

An AI-assisted novel writing app that helps authors generate outlines, characters, worldbuilding and chapters, self-hosted with FastAPI, React and PostgreSQL. MuMuAINovel is a web-based writing assistant for long-form fiction. It uses large language models to generate story outlines, character and organization profiles, and worldbuilding settings through a guided project wizard, then lets authors create, edit, regenerate and polish chapters. Character relationships and organizational structures can be viewed and managed visually.

Is MuMuAINovel free to use? What license does it have?

MuMuAINovel is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.

Is MuMuAINovel still maintained?

Actively maintained. The last commit to MuMuAINovel was on Oct 16, 2026.

What can I use MuMuAINovel for?

Drafting a novel's outline, cast and setting before writing chapters. Managing a multi-book project with many characters and factions. Running a shared self-hosted writing tool for a small group of authors.

How do I install MuMuAINovel?

Clone the repository: git clone https://github.com/xiamuceer-j/MuMuAINovel.git Create the .env configuration file from the example and fill in your API keys and database password: cp backend/.env.example .env Start the services with Docker Compose: docker-compose up -d Open http://localhost:8000 in your browser

Where can I get MuMuAINovel?

The source code and installation instructions are on GitHub: https://github.com/xiamuceer-j/MuMuAINovel