| name | openrag_dev_stack |
| description | Start, monitor, restart, or stop the local OpenRAG dev stack (Docker infra + host backend + host frontend). Use when the user says "start the dev stack", "run the app locally", "restart the backend/frontend", "factory-reset", "is the stack up?", or asks to bring services up/down for local development. |
OpenRAG local dev stack
The local dev setup has three parts that normally run in three terminals. As an agent, run them from one session: part 1 is a detached Docker command, parts 2 and 3 are long-running processes you must launch in the background (however your runtime runs a command without blocking) and monitor.
Run everything from the repo root.
1. Infrastructure (OpenSearch, Langflow, Dashboards)
make dev-local-cpu
- Builds langflow/opensearch images if needed, then starts containers detached — the command itself exits when containers are up. Run it in the foreground (first run can take several minutes if images need building; use a generous timeout).
- Endpoints: Langflow http://localhost:7860, OpenSearch http://localhost:9200, Dashboards http://localhost:5601.
- Verify with
docker compose ps — expect opensearch, dashboards, and langflow containers running/healthy. Wait for OpenSearch to be healthy before starting the backend.
2. Backend (host process)
make backend
- Long-running (uvicorn via
uv run python src/main.py) — launch in the background with its output captured somewhere you can read back. If your runtime already captures background output, don't also tee to a log file.
- Requires
.env in the repo root (the target errors clearly if missing; fix by copying ).
