Craft sprawling web novels, maintain zero-plot-hole continuity, and generate cinematic book trailers in one cohesive desktop workspace.
Tailored for Progression Fantasy, LitRPG, Wuxia/Xianxia, Grimdark, and Sci-Fi authors.
⬇️ Download Windows Installer • ✨ Key Features • 🎬 Video Animation Studio • 🛡️ Security Architecture • 🚀 Quick Start
Manage multiple universes, word metrics, and chapter completion progress from an atmospheric dark workstation.
Orchestrate premise generation, beat structuring, faction world-building, character sheets, and chapter generation with real-time fact checks.
Generate animated cliffhangers, lore breakdowns, and social video shorts straight from your novel chapters.
Move beyond single-prompt chatbots into a disciplined writing framework:
- Phase 1: High-Concept Brainstorming — Extract unique hooks, power systems, core conflicts, and tropes.
- Phase 2: Narrative Beat Structuring — Scaffold plot arcs using industry frameworks (Save the Cat!, Hero's Journey, Dan Harmon Story Circle, Kishōtenketsu).
- Phase 3: Deep World Bible & Plot Outline — Build codified laws of magic, faction hierarchies, geopolitical tension, and chapter-by-chapter beat sheets.
- Phase 4: Character Fact Locking — Define protagonists, foils, and antagonists with tracked status, motives, combat tiers, and evolving relationship dynamics.
- Phase 5: Chapter Writing & Humanizer Loop — Generate rich 2,500–5,000 word chapters while automatically filtering overused AI clichés and repetitive sentence patterns.
- Fact-Locked Memory: Automatically verifies character traits, acquired abilities, and active vows against draft prose.
- Rolling Summary Indexer: Updates story state after each completed chapter to keep LLMs context-aware across 100+ chapter sagas.
- Repetition Blocklist: Global and per-novel banned phrase filters catch AI tropes ("a testament to", "little did he know", "tapestry").
Bring your web novel to life across TikTok, YouTube Shorts, and Webtoon trailers:
- Hyperframes Engine: Dynamic HTML/CSS/GSAP timeline video rendering.
- Remotion Engine: Programmatic React-based kinetic typography and chapter teasers.
- Manim Engine: Mathematical visualizations for cultivation paths, mana grids, and stats.
- Motion Canvas & HTML-Video: Interactive 2D vector animation canvases.
- Local Privacy (Ollama): Run offline with local open weights (
DeepSeek-R1,Qwen 2.5 72B,Mistral Nemo). - Cloud Power (OpenRouter & NVIDIA NIM): Stream state-of-the-art models with live token metrics.
- Zero Vendor Lock-In: Store projects in portable, human-readable
.mdand.jsonalongside embedded SQLite (sql.jsWebAssembly).
WebNovel Forge incorporates rigorous defense-in-depth engineering verified through automated security audits:
| Security Vector | Implementation Detail | Status |
|---|---|---|
| Iframe Sandbox Isolation | Video Studio previews run in isolated sandbox="allow-scripts" with srcdoc, strictly disallowing parent IPC bridge escapes. |
✅ Confined |
| Path Traversal Defense | Strict canonical root confinement (assertSafeSubpath) blocks directory traversal (../) across all reads, writes, and deletions. |
✅ Hardened |
| Zero Shell Injection | Eliminated shell string interpolations; all child processes (powershell.exe, python, npx) execute with discrete argument arrays. |
✅ Parameterized |
| SQL Query Guardrails | Renderer-level IPC SQL gateway verifies path containment and blocks stacked statements (;) and administrative SQLite pragmas. |
✅ Enforced |
| Encrypted Credential Storage | Cloud API keys (openRouterApiKey, nvidiaApiKey) are encrypted at rest using Windows DPAPI via Electron safeStorage. |
✅ Encrypted |
| Renderer Sandbox & CSP | sandbox: true enabled on browser webPreferences; strict Content Security Policy (<meta> tag) prevents unapproved script/origin execution. |
✅ Protected |
WebNovel Forge is engineered for native performance across Windows, macOS, and Linux:
| Platform | Format | Architecture | Status | Direct Download / CLI |
|---|---|---|---|---|
| Windows | .exe (NSIS Installer & Portable) |
x64 | ✅ Supported | Download Setup .exe |
| macOS | .dmg & .zip |
Apple Silicon (M1/M2/M3/M4) & Intel x64 | ✅ Supported | npm run dist:mac / ./LAUNCHER.sh |
| Linux | .AppImage & .deb |
x64 (Ubuntu, Debian, Fedora, Arch) | ✅ Supported | npm run dist:linux / ./LAUNCHER.sh |
Choose your OS below to download, install, or launch WebNovel Forge directly from your terminal:
PowerShell One-Liner (Download & Launch Installer):
Invoke-WebRequest -Uri "https://github.com/rushikin/webnovel-forge/releases/download/v2.0.0/WebNovel.Forge.Setup.2.0.0.exe" -OutFile "$env:TEMP\WebNovelForgeSetup.exe"; Start-Process "$env:TEMP\WebNovelForgeSetup.exe"Command Prompt / curl:
curl -L -o "%TEMP%\WebNovelForgeSetup.exe" "https://github.com/rushikin/webnovel-forge/releases/download/v2.0.0/WebNovel.Forge.Setup.2.0.0.exe" && "%TEMP%\WebNovelForgeSetup.exe"Developer Clone & One-Click Start:
git clone https://github.com/rushikin/webnovel-forge.git && cd webnovel-forge && npm install && RUN_SINGLE_FILE.batOne-Liner Clone & Launch:
git clone https://github.com/rushikin/webnovel-forge.git && cd webnovel-forge && npm install && chmod +x LAUNCHER.sh && ./LAUNCHER.shBuild Standalone macOS .dmg Installer Locally:
npm run dist:mac
# Output will be located in: release/WebNovel-Forge-2.0.0-mac.dmgStart in Development Mode:
./LAUNCHER.sh --devOne-Liner Clone & Launch:
git clone https://github.com/rushikin/webnovel-forge.git && cd webnovel-forge && npm install && chmod +x LAUNCHER.sh && ./LAUNCHER.shBuild Native .AppImage & .deb Packages Locally:
npm run dist:linux
# Outputs generated in release/:
# - release/WebNovel-Forge-2.0.0-linux.AppImage
# - release/WebNovel-Forge-2.0.0-linux.debInstall the .deb package (Debian / Ubuntu / Mint):
sudo dpkg -i release/WebNovel-Forge-2.0.0-linux.deb# Clone the repository
gh repo clone rushikin/webnovel-forge
# Or download latest release assets
gh release download v2.0.0 --repo rushikin/webnovel-forge- Node.js (v18.x or v20.x LTS)
- npm (v9.x or v10.x)
- (Optional for Video Trailers) FFmpeg
- (Optional for Local AI) Ollama running locally on port 11434
git clone https://github.com/rushikin/webnovel-forge.git
cd webnovel-forge
npm install-
On Linux / macOS:
chmod +x LAUNCHER.sh ./LAUNCHER.sh # Starts built app ./LAUNCHER.sh --dev # Starts in development mode
-
On Windows:
RUN_SINGLE_FILE.bat # Or: node LAUNCHER.js
# Build for your current host operating system
npm run dist
# Target-specific packaging commands
npm run dist:win # Windows Setup .exe (NSIS)
npm run dist:mac # macOS .dmg & .zip (Universal)
npm run dist:linux # Linux .AppImage & .deb
npm run dist:all # Package all platform distributionswebnovel-forge/
├── src/
│ ├── main/ # Electron Main Process (Node.js)
│ │ ├── main.ts # IPC controllers, window lifecycle, safe storage
│ │ ├── securityUtils.ts # Canonical path confinement & SQL guardrails
│ │ ├── pipeline.ts # 5-Phase autonomous story generation engine
│ │ ├── dataModel.ts # SQLite WebAssembly (sql.js) schemas & file CRUD
│ │ ├── editorAgent.ts # Continuity analyzer & fact checking agent
│ │ └── videoEngines/ # Hyperframes, Remotion, Manim render dispatchers
│ ├── renderer/ # React 18 User Interface (Vite)
│ │ ├── pages/ # Library, Workspace, Video Studio, Settings
│ │ ├── components/ # Timeline, Fact Inspector, Outline Grid
│ │ └── styles/ # Tailwind CSS design system & typography tokens
│ └── shared/ # Cross-process IPC types & contract definitions
├── assets/ # Logos, SVG icons, and preview screenshots
└── package.json # Build manifests & Electron configuration
- Frontend: React 18, TypeScript, Tailwind CSS, Lucide Icons, Vite
- Desktop Runtime: Electron 28 (sandboxed with context isolation)
- Local Database: WebAssembly SQLite (
sql.js) with mutex locking - Video Compilers: Hyperframes, Remotion, Manim, Motion Canvas
Contributions, feature requests, and bug reports are welcome!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'feat: add amazing feature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.