First role-gated query
The repo ships with uv, a Makefile, and a Docker Compose file. Pick whichever fits your machine. make dev is the fastest path: it creates a virtualenv, installs deps, and starts Gradio on port 7860.
# Get a key at https://openrouter.ai/keys (free tier works for this course)
OPENROUTER_API_KEY=your_openrouter_key_here
OPENROUTER_MODEL=minimax/minimax-m2:free
# Local embeddings. No API key needed.
EMBEDDING_MODEL=all-MiniLM-L6-v2
One API key is enough. The embeddings run locally through sentence-transformers.
terminal
bash
git clone https://github.com/learnwithparam/rbac-rag-chatbot.git
cd rbac-rag-chatbot
cp .env.example .env
# paste your OPENROUTER_API_KEY into .env
make dev
# Gradio UI: http://localhost:7860
One setup command. After this you have a three-tab UI running with seeded users and documents.
AI prompt: Run the wall-check
Loading practice…
Validation checklist: First role-gated query checklist
Loading practice…