Webnovel Writer is an AI-assisted long-form web novel creation system designed to mitigate common AI writing issues like "forgetting" and "hallucinations." Targeting authors engaged in serial web novel production, it enables continuous writing projects up to 2 million characters, enhancing narrative consistency and reducing AI-generated errors.

How It Works

This system is built upon Claude Code, acting as the primary AI writing environment. It employs Retrieval-Augmented Generation (RAG) techniques to provide relevant context, thereby combating AI memory lapses and factual inaccuracies. The approach utilizes specific embedding and reranking models, such as Qwen for embeddings and Jina for reranking, to efficiently retrieve and prioritize contextual information, ensuring a more coherent and reliable long-form narrative flow.

Quick Start & Requirements

• Installation: Install via Claude plugin marketplace: claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user followed by claude plugin install webnovel-writer@webnovel-writer-marketplace --scope user. Python dependencies can be installed using python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/webnovel-writer/scripts/requirements.txt.
• Prerequisites: Requires Claude Code environment, Python 3.x, and API keys for embedding and reranking services.
• Initialization: Execute /webnovel-init within Claude Code to create a new project workspace.
• RAG Configuration: Create a .env file in the project root, specifying EMBED_BASE_URL, EMBED_MODEL (e.g., Qwen/Qwen3-Embedding-8B), EMBED_API_KEY, RERANK_BASE_URL, RERANK_MODEL (e.g., jina-reranker-v3), and RERANK_API_KEY.
• Usage: Commands include /webnovel-plan 1, /webnovel-write 1, and /webnovel-review 1-5.

Highlighted Details

• Supports serial writing projects up to 2 million characters.
• Version 5.3 introduced a "readership engagement system" (追读力系统) with features like Hook, Cool-point, micro-monetization, and debt tracking.
• Enhanced intelligent RAG context assistance, with automatic fallback to BM25.
• Developed using Claude Code, Gemini CLI, and Codex with a Vibe Coding methodology.

Maintenance & Community

Contributions are welcomed via Issues and Pull Requests. Specific community channels (e.g., Discord, Slack) or a public roadmap are not detailed in the README.

Licensing & Compatibility

The project is licensed under GPL v3. This strong copyleft license requires derivative works to also be licensed under GPL v3, potentially impacting integration into closed-source commercial applications.

Limitations & Caveats

The system's functionality is tightly coupled with the Claude Code environment and its plugin infrastructure. It necessitates external API keys and potentially incurs costs for embedding and reranking services. The GPL v3 license imposes significant obligations on any modifications or derivative works. Specific hardware requirements for optimal performance are not explicitly stated.