beattrack

Find songs that sound alike — sonic similarity search powered by audio fingerprinting and vector embeddings.

Stack

• Frontend: Next.js 15, React 19, TypeScript, Tailwind CSS
• Backend: FastAPI, Python 3.12, Essentia, Chromaprint/pyacoustid
• Monorepo: Bun workspaces

Development

bun install
bun run dev        # Frontend (apps/web)

cd apps/api
uv sync --extra dev
uv run uvicorn app.main:app --reload

Testing

bun run test       # Frontend unit tests
uv run pytest      # Backend tests

License

AGPL-3.0 — see LICENSE