Initial Animatrix import

README.md

@@ -0,0 +1,103 @@
+# 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:
+
+```bash
+cd backend
+python3.12 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+cp .env.example .env
+python run.py
+```
+
+Frontend:
+
+```bash
+cd frontend
+npm install
+cp .env.local.example .env.local
+npm run dev
+```
+
+Local production-style frontend build:
+
+```bash
+./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](F:/Workin%20In%20Progress/DESINEURON/GITLAB/Animatrix/Animatrix%20Project%20Truth.md)
+
+This README is the first stronger pass and should continue to evolve with deployment truth, workflow inventory, and operator runbooks.