avi/S.H.O.N.A.R._Desktop_Companion
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
S.H.O.N.A.R._Desktop_Companion/backend
History
Exact
avi b4e335d720 Model registry: Large v3 speed label corrected to measured ~0.3-0.4x real-time (CPU int8 quiet-machine benchmark Sep 22: 0.27x on 300s, 0.43x on 1200s; prior '~1x' was optimistic)
2026-09-22 10:38:34 -05:00
..
migrations Migrations no longer clobber app logging: drop fileConfig(alembic.ini) from migrations/env.py. fileConfig rewrote the root logger (WARN + disable_existing) during the engine's startup migration, silently muting every INFO line afterwards — engine.log froze at the migration's last line and uvicorn access logs vanished, swallowing the TRACE instrumentation. The app owns logging (main.py basicConfig); alembic.ini's [loggers] applied only to standalone CLI runs. Verified: fresh engine boot now logs access lines live (GET /jobs flowing), 83 tests pass. 2026-09-18 13:13:40 -05:00
shonar Model registry: Large v3 speed label corrected to measured ~0.3-0.4x real-time (CPU int8 quiet-machine benchmark Sep 22: 0.27x on 300s, 0.43x on 1200s; prior '~1x' was optimistic) 2026-09-22 10:38:34 -05:00
tests Raw provider crash fails the job instead of escaping into the sweep requeue loop 2026-09-19 15:24:50 -05:00
alembic.ini Standalone Shonar Desktop: vendor portable sources + local engine; decouple from ~/Projects/Shonar 2026-09-14 17:14:54 -05:00
pyproject.toml Standalone Shonar Desktop: vendor portable sources + local engine; decouple from ~/Projects/Shonar 2026-09-14 17:14:54 -05:00
README.md Bundle the whisper base model + one-shot standalone provisioning 2026-09-14 21:05:41 -05:00
uv.lock Icons: brand blue (#6190E5) for in-app sonar logo and window/taskbar icon; recolor icon.png, ship as window icon 2026-09-21 15:45:12 -05:00

README.md

S.H.O.N.A.R. backend (desktop bundled-lite)

FastAPI engine for SHONAR Desktop, running standalone on this machine: SQLite + in-process queue, self-migrating on boot. No Postgres/Redis/Docker.

Setup (this repo is self-contained)

cd backend
uv venv .venv && uv pip install -p .venv/bin/python -e ".[dev,faster-whisper]"

The app (DesktopState) creates this venv's env vars itself, including HF_HUB_CACHE=models/hf-cache — the base faster-whisper model is vendored under models/hf-cache/ (gitignored; copy from any HF cache to reprovision).

Tests: .venv/bin/python -m pytest (SQLite by default; point SHONAR_TEST_DATABASE_URL at Postgres to test that path) · Lint: ruff check . · Migrations: alembic upgrade head