Architecture
V2 foundation
This repository is the first safe foundation for a Hugging Face-native Agentic Space Factory.
User
↓
Gradio orchestrator Space with HF OAuth
↓
HF Job launched with the user's OAuth token
↓
Mounted private Storage Bucket at /output
↓
Optional private target Space creation
↓
Live Gradio API validation
↓
Bucket report + state + events
Current phases
Phase 1 — Hello Job
Validates:
OAuth → Jobs scope → HF Job → mounted Bucket → readback UI
Phase 2 — Private target Space
Validates:
OAuth → HF Job → create private Gradio Space → upload files → live API test → report
The target Space is private by default and must be created in the signed-in user's namespace.
Why Phase 2 is intentionally simple
Before adding Pi, model-card analysis, or ZeroGPU, we need to prove that the system can safely create a target Space and validate it through the live API.
That live API validation gate will later remain the core success criterion.
Phase 6
Adds a no-build runtime recommender Job that analyzes model metadata and writes runtime_recommendation.json to the Bucket.
Phase 7 — LongCat article reproduction
Phase 7 attempts an article-style LongCat Space build: private target Space, Pi-guided app adaptation, ZeroGPU first, fixed GPU fallback when explicitly enabled, and live /health API validation. Full video generation remains a manual-review step until model-specific runtime validation is complete.