| # Deploying as a Hugging Face Space | |
| 1. Create a new **Gradio** Space. | |
| 2. Upload the **contents of `space/`** to the Space root. | |
| 3. Add Space Secrets: | |
| - `HF_TOKEN` | |
| - For BigQuery: `GCP_SERVICE_ACCOUNT_JSON`, `GCP_PROJECT` | |
| - For MotherDuck: `MOTHERDUCK_TOKEN`, `MOTHERDUCK_DB` | |
| - Optional tracing: `LANGFUSE_PUBLIC_KEY`, `LANGFUSE_SECRET_KEY`, `LANGFUSE_HOST` | |
| 4. Set `SQL_BACKEND` to `bigquery` or `motherduck`. | |
| 5. Set `HF_MODEL_REPO` to your private model repo id. | |
| 6. (Optional) Set `ORCHESTRATOR_MODEL` for the tiny CPU LLM. |