Artifex/README.md

Artifex V1

Artifex V1 is the bootstrap autonomous engineering control plane defined in docs/artifex_v1_bootstrap_spec.md.

Architecture

• Django application/control plane
• PostgreSQL as canonical persistent state
• Persisted Event Bus
• Project hierarchy: Project -> Milestone -> Feature -> Task -> Action
• Versioned Agent Registry
• Model access through ModelRouter
• LangGraph hidden behind GraphRuntime
• Git worktrees for mutable autonomous tasks
• Checkpoint-native fiction planning, drafting, parallel editorial review, approval, canon, and EPUB publication

Run Locally

Set DATABASE_URL to PostgreSQL for canonical state:

DATABASE_URL=postgresql://artifex:artifex@localhost:5432/artifex python manage.py migrate
python manage.py seed_core_agents
python manage.py runserver

For lightweight local checks only, SQLite can be selected explicitly:

DATABASE_URL=sqlite:///db.sqlite3 python manage.py migrate

See docs/story_authoring_workflow.md for the durable story-authoring workflow and Spark deployment instructions.