Project_Animatix/README.md

Animatrix

Animatrix is a constrained full-stack Wan 2.2 generation surface built on top of the live Desineuron ComfyUI ingress.

It is designed to be a production-facing prompt console, not a node editor.

Current Product Scope

Current live scope:

• local operator auth
• asset upload and library
• grounded start-frame generation
• animate mode
• audio performance surface
• aspect ratio selection
• duration selection
• batch submission from x1 to x4
• result viewing and download

Current non-live scope:

• true end-frame conditioning
• exact loop closure workflows
• additional model families beyond Wan 2.2 A14B

If a control is not wired to the live Comfy workflow, it should not be treated as production-capable.

Repository Structure

• frontend/: Next.js operator surface
• backend/: FastAPI API, auth, storage, orchestration
• workflows/: versioned ComfyUI workflow templates
• infra/: deployment and service scaffolding
• scripts/: utility scripts
• Animatrix Project Truth.md: project truth artifact

Runtime Topology

Production topology today:

• frontend: Linux box
• backend: Linux box
• public host: animatrix.desineuron.in
• Comfy target: https://comfy.desineuron.in
• GPU execution: AWS GPU box using local Wan models on NVMe

The app should never assume direct browser access to the GPU box.

Local Development

Backend:

cd backend
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python run.py

Frontend:

cd frontend
npm install
cp .env.local.example .env.local
npm run dev

Local production-style frontend build:

./scripts/build_frontend_standalone.sh

Production Configuration Notes

Expected production assumptions:

• frontend browser calls use same-origin /api
• backend COMFYUI_BASE_URL points to https://comfy.desineuron.in
• backend BACKEND_BASE_URL points to https://animatrix.desineuron.in
• Linux box stores app DB, uploaded assets, and persisted outputs
• GPU box stores ComfyUI runtime and Wan model files on NVMe

Operational Notes

Two truths matter in production:

1. A valid workflow file does not guarantee a valid runtime.
2. Comfy loader availability must match the model names referenced in the workflow.

Animatrix now depends on live runtime model preflight to avoid silent drift.

Documentation

Start with:

• Animatrix Project Truth.md

This README is the first stronger pass and should continue to evolve with deployment truth, workflow inventory, and operator runbooks.