| # Architecture |
|
|
| ## V2 foundation |
|
|
| This repository is the first safe foundation for a Hugging Face-native Agentic Space Factory. |
|
|
| ```text |
| 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: |
|
|
| ```text |
| OAuth → Jobs scope → HF Job → mounted Bucket → readback UI |
| ``` |
|
|
| ### Phase 2 — Private target Space |
|
|
| Validates: |
|
|
| ```text |
| 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. |
|
|
