How gandholi-kumar/curiokraft-coloring-book works
CurioKraft is a multi-agent coloring-book production and Amazon KDP publishing engine, with CLI and Publishing Studio API entry points. Its documented workflow runs manifest-driven prompt design and image generation, rescues and validates artwork, composes cover and interior PDFs, then performs KDP preflight and metadata/publishing support. Storage and synchronization provide persistent local/cloud asset management. The README documents these capabilities; only selected source excerpts were available, so links among unsampled stages are limited to documented workflow relationships.
Main entry points: cli.py Production CLI · batch_runner.py Batch Runner · routes.py Studio Routes · hybrid_store.py Hybrid Store
Components 27
User Interfaces
- Production CLI
src/curiokraft_book/cli.py - Studio API
src/curiokraft_book/api/app.py - Studio Routes
src/curiokraft_book/api/routes.py - Live Events
src/curiokraft_book/api/websocket_manager.py
Book Production
- Book Manifest
src/curiokraft_book/orchestrator/blueprint_reader.py - Agent Debate
src/curiokraft_book/orchestrator/debate_engine.py - Text Models
src/curiokraft_book/orchestrator/llm_client.py - Model Providers
src/curiokraft_book/orchestrator/providers.py - Image Generation
src/curiokraft_book/orchestrator/image_generator.py - Batch Runner
src/curiokraft_book/orchestrator/batch_runner.py - Pipeline State
src/curiokraft_book/orchestrator/state_manager.py
Artwork Quality
- Image Rescue
src/curiokraft_book/rescue - Artwork Validators
src/curiokraft_book/validators - Book QA
src/curiokraft_book/agents/book_qa.py
KDP Publishing
- Cover Composer
src/curiokraft_book/compositor/cover.py - Interior PDF
src/curiokraft_book/compositor/interior_pdf.py - KDP Preflight
src/curiokraft_book/validators/kdp_preflight.py - KDP Metadata
src/curiokraft_book/agents/kdp_publisher.py - KDP Form Parser
src/curiokraft_book/agents/kdp_parser.py
Data and Operations
- Hybrid Store
src/curiokraft_book/data/hybrid_store.py - Relational Store
src/curiokraft_book/data/postgres_store.py - Asset Storage
src/curiokraft_book/data/object_storage.py - Cloud Sync
src/curiokraft_book/data/sync_engine.py
Other components
- Book Producer
- S3/R2 Storage
- Amazon KDP
- LLM Services
Connections 30
- Book Producer → Production CLI: runs
- Book Producer → Studio API: uses
- Studio API → Studio Routes: mounts
- Studio Routes → Live Events: broadcasts events
- Production CLI → Batch Runner: starts batches
- Batch Runner → Book Manifest: reads pages
- Batch Runner → Agent Debate: requests prompts
- Agent Debate → Text Models: calls model
- Text Models → Model Providers: dispatches
- Model Providers → LLM Services: calls
- Batch Runner → Image Generation: generates artwork
- Batch Runner → Pipeline State: tracks progress
- Studio Routes → Hybrid Store: reads/writes books
- Pipeline State → Hybrid Store: persists state
- Image Generation → Image Rescue: rescues artwork
- Image Rescue → Artwork Validators: checks output
- Studio Routes → Image Rescue: rescues ingested images
- Production CLI → Cover Composer: builds cover
- Production CLI → Interior PDF: assembles PDF
- Production CLI → KDP Preflight: runs checks
- Production CLI → KDP Metadata: generates metadata
- KDP Metadata → KDP Form Parser: uses form parsing
- Book QA → Artwork Validators: checks book
- Hybrid Store → Relational Store: persists records
- Hybrid Store → Asset Storage: stores assets
- Production CLI → Cloud Sync: requests sync
- Cloud Sync → Relational Store: syncs records
- Cloud Sync → S3/R2 Storage: syncs assets
- Asset Storage → S3/R2 Storage: stores objects
- Book Producer → Amazon KDP: publishes files