How phaethix/inkstone works
Inkstone turns a local novel into comic pages and exports them as PDF or webtoon PNG. Users start generation through the CLI or local web backend; the pipeline segments text, extracts story assets, plans pages, generates artwork, applies character-consistency prompts and lettering, then exports results. Project checkpoints support resume, while the web supervisor retries transient failures and reports progress. The README documents optional legacy panel composition, alias review, and provider alternatives; these are included, but unsampled implementation details are not expanded.
Main entry points: creative_comic.py Comic Orchestrator · chat_provider.py Chat Provider · image_provider.py Image Provider · server.py Web Backend
Components 23
User Interfaces
- CLI
core/cli.py - Web Backend
web/server.py
Generation Pipeline
- Run Supervisor
core/pipelines/run_until_complete.py - Comic Orchestrator
core/pipelines/creative_comic.py
Story and Identity
- Text Segmentation
core/comic/segmentation.py - Story Planning
core/screenwriter.py - Visual Bible
core/comic/visual_bible.py - Identity Consistency
core/comic/identity.py - Consistency Prompts
core/comic/consistency.py
Artwork and Rendering
- Page Lettering
core/comic/page_lettering.py - Font Handling
core/comic/fonts.py - Panel Layout
core/comic/layout.py - PDF / PNG Export
core/comic/export.py
Providers and State
- Project Models
core/schemas.py - Chat Provider
core/api/chat_provider.py - Image Provider
core/api/image_provider.py - Project Checkpoint
core/schemas.py - API Reliability
core/api/retry.py
Other components
- User
- Agnes Chat API
- Agnes Image API
- OpenAI-Compatible API
- Comic Artifacts
Connections 25
- User → CLI: runs
- User → Web Backend: submits novel
- CLI → Comic Orchestrator: starts generation
- Web Backend → Run Supervisor: starts supervised run
- Run Supervisor → Comic Orchestrator: retries run
- Comic Orchestrator → Text Segmentation: splits text
- Comic Orchestrator → Story Planning: requests extraction and plans
- Story Planning → Chat Provider: requests structured results
- Chat Provider → Agnes Chat API: calls chat API
- Chat Provider → OpenAI-Compatible API: calls compatible chat API
- Comic Orchestrator → Visual Bible: reconciles identities
- Comic Orchestrator → Identity Consistency: applies identity rules
- Comic Orchestrator → Consistency Prompts: builds consistency prompts
- Comic Orchestrator → Image Provider: requests artwork
- Image Provider → Agnes Image API: generates images
- Image Provider → OpenAI-Compatible API: generates images
- Comic Orchestrator → Page Lettering: letters finished pages
- Page Lettering → Font Handling: uses fonts
- Comic Orchestrator → Panel Layout: lays out legacy panels
- Comic Orchestrator → PDF / PNG Export: binds pages or strip
- Comic Orchestrator → Project Checkpoint: saves and resumes state
- Web Backend → Project Checkpoint: reads project progress
- PDF / PNG Export → Comic Artifacts: writes PDF or PNG
- Chat Provider → API Reliability: uses retries
- Image Provider → API Reliability: uses retries