---
title: Internal Portal API
emoji: 🏢
colorFrom: indigo
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# Internal Portal API (backend)

FastAPI backend for the internal portal chat app. Provides domain/project
management, a chat endpoint backed by **DeepSeek**, and an HR assistant grounded
in uploaded documents.

## Deploy on Hugging Face Spaces

1. Create a new Space → **Docker** SDK.
2. Push the contents of this `backend/` folder to the Space repo (this README's
   YAML header configures the Space; `app_port: 7860` matches the Dockerfile).
3. In **Settings → Variables and secrets**, add:
   - `DEEPSEEK_API_KEY` (secret) — your DeepSeek key
   - `DEEPSEEK_MODEL` — your exact model id (e.g. the "v4 flash" model string)
   - `DEEPSEEK_BASE_URL` — optional, defaults to `https://api.deepseek.com`
   - `ALLOWED_ORIGINS` — your Vercel URL, e.g. `https://your-app.vercel.app`
     (defaults to `*` for easy first testing)
4. The Space builds and serves at `https://<user>-<space>.hf.space`.

Check it's up: `GET https://<space-url>/api/health` →
`{"ok": true, "llm_configured": true, "model": "..."}`.

## Run locally

```bash
cd webapp/backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
export DEEPSEEK_API_KEY=sk-...           # your key
export DEEPSEEK_MODEL=deepseek-chat       # or your "v4 flash" model id
uvicorn app.main:app --reload --port 7860
```

Then open http://localhost:7860 — the backend also serves the static frontend
from `../frontend` for convenience, so you can test the whole app from one
process locally.

## Storage note

Data is persisted to a JSON file under `DATA_DIR` (`/data` in Docker). **A free
HF Space's disk is ephemeral** — it resets on rebuild/restart. That's fine for
development and demos. When durable storage is needed, the `store.py` layer is
swappable for a real database without changing the rest of the app.