# 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.