Name		Name	Last commit message	Last commit date
parent directory ..
Dockerfile		Dockerfile
MADMOM_INTEGRATION.md		MADMOM_INTEGRATION.md
README.md		README.md
analysis.py		analysis.py
chord_madmom.py		chord_madmom.py
chord_ml.py		chord_ml.py
debug_youtube.py		debug_youtube.py
main.py		main.py
preload_models.py		preload_models.py
requirements.txt		requirements.txt
test_cobalt.py		test_cobalt.py
test_features.py		test_features.py
test_madmom.py		test_madmom.py
test_main.py		test_main.py
websocket_chords.py		websocket_chords.py
youtube.py		youtube.py

README.md

Chord AI Backend

FastAPI service providing /api/analyze for the Guitariz frontend.

Requirements

Python 3.12+
ffmpeg available on PATH

Setup

python -m pip install -r requirements.txt

Run locally

python -m uvicorn main:app --port 8001

Endpoint: http://localhost:8001/api/analyze

Frontend integration

Set an env for the frontend so it calls the backend:

VITE_CHORD_AI_API=http://localhost:8001/api/analyze

If unset, the frontend will fall back to local (less accurate) analysis.