AppDB

AppDB

appdb/ in the repository is a small Python/FastAPI + SQLite web app for collecting app-compatibility reports for HyperHLE. Public instance: https://appdb.touchhle.org

Run it locally

cd appdb
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

The SQLite database is created and seeded with demo data on first startup.

Optional configuration (env vars)

Variable	Effect when absent
GITHUB_OAUTH_CLIENT_ID / GITHUB_OAUTH_CLIENT_SECRET	Submitting reports requires GitHub OAuth; without these the app is read-only
APPDB_TRIAGE_TOKEN	The triage JSON API is disabled

Related

• Reports drive priorities — see Compatibility for how dumps + reports fit together.
• Source of truth for setup: the repo's appdb/README.md and AGENTS.md.