Ragstar — AI Data Analyst for dbt Projects

Ragstar is in public βeta. Expect rapid changes and occasional rough edges.

1. What is Ragstar?

Ragstar connects to your dbt project, builds a knowledge base from models & documentation, and lets everyone ask data-related questions in plain English via a beautiful web dashboard or Slack. Under the hood Ragstar combines:

• PostgreSQL + pgvector for fast similarity search
• Embeddings + LLMs (OpenAI, Anthropic, etc.) for reasoning
• A modern Next.js frontend & Django backend

Screenshots

Dashboard

Integrations

Settings

2. Quick start (🚀 2 commands)

# ① clone & prepare env file
$ git clone https://github.com/pragunbhutani/ragstar.git && cd ragstar
$ cp .env.example .env && ${EDITOR:-vi} .env  # ⇒ edit just the vars shown below

# ② build & run everything
$ docker compose up --build -d

When the containers are healthy:

• Frontend: http://localhost:3000 (Next.js)
• API: http://localhost:8000 (Django/DRF)
• Flower: http://localhost:5555 (background tasks)

Run first-time Django tasks:

# inside the running backend container
$ docker compose exec backend-django \
    uv run python manage.py migrate

🎉 That's it — open http://localhost:3000, sign up for a new account and you're ready to start using Ragstar.

3. Environment variables

Only a handful of variables are truly required for a local/dev install. The rest are advanced overrides.

Ragstar keeps the default stack as lightweight as possible.
For a local docker compose run you only need 3 variables – everything else has sane fall-backs.

3.1 Required for local/dev

| Var | Example | Purpose | | --------------------- | ------------------------- | ---------------------------------------------------- | | NEXTAUTH_SECRET | openssl rand -base64 32 | Secret used by next-auth to sign session cookies | | NEXTAUTH_URL | http://localhost:3000 | Public URL where the frontend is reachable | | NEXT_PUBLIC_API_URL | http://localhost:8000 | Public URL of the Django API exposed to the browser |

Create a .env file in the repo root and paste the three lines above (adjust URLs if you changed the ports).

3.2 Common overrides (optional)

| Var | Default | When you might set it | | ------------------------------------------------------------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------ | | INTERNAL_API_URL | http://backend-django:8000 | Only needed when the frontend talks to the backend across Docker networks or remote hosts. | | ENVIRONMENT | local | Switch between local, development, production behaviour inside Django settings. | | APP_HOST | — | Extra hostname to append to Django ALLOWED_HOSTS & CORS lists, e.g. your public Ngrok / Vercel host. | | DATABASE_URL

... View full README on GitHub