Files
homarr/tools/assistant-benchmark/README.md
T
+12 fcd7c979df feat!: release v2 (#6545)
Co-authored-by: Artur <145776561+arturict@users.noreply.github.com>
Co-authored-by: arturict <arturict@users.noreply.github.com>
Co-authored-by: Thomas <thomas@ajnart.fr>
Co-authored-by: Afonso Jorge Ramos <afonsojorgeramos@gmail.com>
Co-authored-by: Danura30082 <danura30082+github@gmail.com>
Co-authored-by: Kushie <122986913+kushiemoon-dev@users.noreply.github.com>
Co-authored-by: ajnart <thomas@ajnart.fr>
Co-authored-by: ajnart <thomas@ajnart.dev>
Co-authored-by: chenjun <chenjun@foxmail.com>
Co-authored-by: Wikibear <wikibear@users.noreply.github.com>
Co-authored-by: Bergasha <bergasha@gmail.com>
Co-authored-by: leafyelin <43306196+leafyelin@users.noreply.github.com>
Co-authored-by: Lucas Araujo <lucas.lra@gmail.com>
Co-authored-by: GreenMonito <86085570+GreenMonito@users.noreply.github.com>
Co-authored-by: Nerdy-Technician <roffo@nerdy-technician.social>
Co-authored-by: Jun <34545896+jcstrong@users.noreply.github.com>
Co-authored-by: Edmond Abraham <54119952+gitedmond@users.noreply.github.com>
Co-authored-by: thrawnx <tight.bulb9384@fastmail.com>
Co-authored-by: Chris <58918656+nordada@users.noreply.github.com>
Co-authored-by: yi111 <153097222+Yi-111-a@users.noreply.github.com>
Co-authored-by: Yanis <naamaneyanis@gmail.com>
Co-authored-by: Wikibear <me@sej.de>
Co-authored-by: alessiottavo <93441886+alessiottavo@users.noreply.github.com>
2026-10-02 21:00:14 +02:00

32 lines
1.9 KiB
Markdown

# Local assistant API fixtures
Start manually with the QA app's local date:
```sh
BENCHMARK_DATE=2026-09-24 node tools/assistant-benchmark/server.mjs
```
The server listens only on `127.0.0.1:18094`, makes no outbound requests, and
rejects writes. It is not connected to CI. `/health` returns the fixture date
and method/path counters; it never logs request headers.
| Base path | Supported GET paths | Synthetic authentication |
| --------------- | -------------------------------------------------------------- | ---------------------------------------------- |
| `/sonarr` | `/api/v3/series`, `/api/v3/queue` | `X-Api-Key: benchmark-sonarr-key` |
| `/mealie` | `/api/households/mealplans/today`, `/api/households/mealplans` | `Authorization: Bearer benchmark-mealie-token` |
| `/openlibrary` | `/search.json` | None |
| `/openmeteo/v1` | `/forecast`, `/search` | None |
These credentials are public dummy values, not real service keys. Configure
them only in isolated QA integrations. Custom Widget HTTP sources need
`networkScope: "loopback"`; do not relax production network policy.
Supported response subsets and provenance are documented in `server.mjs`.
This is not a full service emulator. Unknown paths return 404; unsupported
weather variables return 400. Library queries support `q`/`title`, `limit`,
`page`/`offset`, and `fields`. Weather supports Berlin/Paris geocoding and
Celsius/Fahrenheit forecasts. Mealie includes two meals today and one tomorrow.
Use the real Homarr assistant and renderer with these fixtures. A successful
mock response alone does not prove widget generation, saving, or rendering.