| --- |
| title: doc-to-lora UI |
| emoji: 🪞 |
| colorFrom: indigo |
| colorTo: blue |
| sdk: docker |
| app_port: 7860 |
| suggested_hardware: cpu-basic |
| pinned: false |
| --- |
| |
| # Etiya doc-to-lora — Web UI |
|
|
| Companion frontend for [`Etiya/d2l-api`](https://huggingface.co/spaces/Etiya/d2l-api). |
|
|
| ## Architecture |
|
|
| ``` |
| Browser |
| │ |
| ▼ |
| Etiya/d2l-ui (this Space — Docker SDK, CPU basic, Next.js) |
| │ |
| │ /api/proxy/* — server-side, adds Authorization: Bearer ${HF_TOKEN} |
| ▼ |
| Etiya/d2l-api (backend Space — A100, doc-to-lora + Gemma-2-2b-it) |
| ``` |
|
|
| The frontend calls the backend Space using a server-side proxy. The HF token is set as a Space Secret on this UI Space and never reaches the browser. |
|
|
| ## Pages |
|
|
| - `/` — hero + quick ask |
| - `/ask` — chat interface with advanced parameter sliders |
| - `/documents` — CRUD for the 1,166 BSS document corpus |
| - `/system` — health, GPU, latency, re-index controls |
|
|
| ## Required Space secret |
|
|
| Set on this Space's `Settings → Variables and secrets → New secret`: |
|
|
| | Name | Type | Value | |
| |---|---|---| |
| | `HF_TOKEN` | Secret | An HF write token with read access to `Etiya/d2l-api` | |
|
|
| Optional: |
|
|
| | Name | Type | Default | |
| |---|---|---| |
| | `D2L_API_URL` | Variable | `https://etiya-d2l-api.hf.space` | |
|
|
| ## Local development |
|
|
| This Space is a regular Next.js 14 app. To work on it locally: |
|
|
| ```bash |
| git clone https://huggingface.co/spaces/Etiya/d2l-ui |
| cd d2l-ui |
| npm install |
| cp .env.example .env.local # add HF_TOKEN |
| npm run dev # http://localhost:3000 |
| ``` |
|
|
| Or via Docker: |
|
|
| ```bash |
| docker compose up --build # http://localhost:3000 |
| ``` |
|
|
| ## Hardware |
|
|
| This Space runs on `cpu-basic` (free) — Next.js is light. The heavy lifting (GPU inference) happens on the backend Space. |
|
|
