Skip to content

Thomashighbaugh/fiction-fabricator

Repository files navigation

Fiction Fabricator

An AI-powered narrative generation system that transforms story concepts into full-length novels and short stories using large language models. Fiction Fabricator employs multi-phase content synthesis, intelligent context management, and interactive editing tools to create fiction manuscripts.

Key Features

  • Multi-Phase Generation: Automated outline creation, content drafting, and iterative refinement
  • Interactive Editing: Chapter management, story element customization, and AI-powered rewrites
  • Lorebook System: Auto-generated world-building entries with Tavern AI compatibility
  • Export Options: EPUB, HTML, Markdown, PDF, and TXT formats
  • Project Management: XML-based state persistence with resume capabilities

Inspired by pulpgen. Built with enhanced modular architecture and XML-based state management.


Quick Start

# 1. Install dependencies (requires Python 3.13+ and uv)
cd fiction-fabricator
uv sync

# 2. Configure API key in .env file
echo "NVIDIA_API_KEY=YOUR_KEY_HERE" > .env

# 3. Run with interactive menu
uv run python main.py

# Or with a prompt file
uv run python main.py --prompt your_idea.txt

# Resume existing project
uv run python main.py --resume projects/your-project-folder

# Import character card
uv run python main.py --character-card path/to/character.json

Get your API key: https://build.nvidia.com/

For detailed setup instructions, see INSTALLATION.md.


Documentation

Documentation Description
Overview Project overview, capabilities, and use cases
Installation Setup guide, requirements, and troubleshooting
Usage Guide Complete walkthrough of features and workflows
New Features Recent additions and advanced quality systems
Architecture Technical design and XML-based state management
AI Agent Architecture Multi-phase agentic design philosophy
Lorebook System World-building and context management
Export Options Output formats and publishing workflows
Configuration API management and system optimization
Prompt Enhancement AI-assisted prompt expansion
Development Guide Code style and contribution guidelines
Changelog Project history and version changes

Examples

File Description
Comprehensive Prompt Detailed story prompt example
Prompt Template Template for creating prompts
Character Card Sample TavernAI/SillyTavern character card
Lorebook Example Sample Tavern AI lorebook

License

MIT License. See LICENSE for details.

About

Python CLI to generate a full-length novels using generative AIs through GPT4Free

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages