README_SPACE.md

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.