Skip to main content

​
1. Install

pip install "ragrails[voyage,openai,qdrant]"

export VOYAGE_API_KEY="..."
export OPENAI_API_KEY="..."
docker run -p 6333:6333 qdrant/qdrant

​
2. Build the index

One command runs the whole pipeline: 
ragrails ingest \
  --docs files/guide.pdf \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --provider voyage --model voyage-3
Prefer control over each step? Run the stages separately and pass JSON between them. See the CLI Overview.

​
3. Query

ragrails query "What does the guide cover?" \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --provider voyage --model voyage-3

​
4. Chat

ragrails chat "What does the guide cover?" \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --llm-provider openai --llm-model gpt-4o-mini
Run ragrails chat with no question to start the interactive session (history, streaming, tools).

​
Next

CLI Overview

Every command.

Interactive chat

Slash commands and agentic tools.