Chat with your database. No external API. Open source. Runs locally.

You ask in plain English, a local LLM writes the SQL, aSql runs it read-only and shows the rows.

Needs Docker and Ollama running on the host.

ollama pull qwen2.5:3b
docker compose up --build

Open http://localhost:3000.

For local SQLite/DuckDB files, drop them into the asql_data volume.

# backend
cd backend && python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# frontend
cd frontend && npm install && npm run dev

Set NEXT_PUBLIC_API_URL=http://localhost:8000 outside Docker.

Apache 2.0.