---
title: ChatDocs API
emoji: 📄
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---

# ChatDocs — Main Server (Hugging Face Space)

This Space runs the FastAPI main server of [ChatDocs](https://github.com/your-username/chatdocs)
in a single container, backed by free managed cloud services.

- **Interactive API docs:** `/docs`
- **Health:** `/`

## Required secrets (Space → Settings → Variables and secrets)

| Name | Example | Notes |
|------|---------|-------|
| `GROQ_API_KEY` | `gsk_...` | LLM (free tier) |
| `PINECONE_API_KEY` | `pcsk_...` | Embeddings (multilingual-e5-large) |
| `QDRANT_URL` | `https://xxxx.cloud.qdrant.io:6333` | Qdrant Cloud cluster |
| `QDRANT_API_KEY` | `...` | Qdrant Cloud key |
| `REDIS_URL` | `rediss://default:pwd@host:6379` | Upstash Redis (use the `rediss://` URL) |
| `MYSQL_URI` | `mysql+pymysql://user:pwd@gateway.tidbcloud.com:4000/db?ssl_ca=/etc/ssl/certs/ca-certificates.crt` | TiDB Serverless / Aiven |
| `JWT_SECRET_KEY` | random 64-hex | Admin login token signing |

These are preset by the Dockerfile but can be overridden:
`USE_RABBITMQ=false`, `UPLOAD_DIR=/tmp/uploads`, `DISABLE_ORIGIN_CHECK=true`.