Skip to main content
ragrails --help
The CLI is a thin layer over the SDK. All commands call RagRails() internally.

​
Commands

CommandStageDescription
setup-urlIngestionInstall Playwright browser for URL ingestion
scrapeIngestionScrape URLs into JSON files
parseIngestionParse local documents into JSON files
fetchIngestionFetch REST API responses into JSON files
chunkChunkingChunk ingestion output JSON files
embedEmbeddingEmbed chunk JSON files and write to an output dir
storeStoringStore embedded chunk JSON files in a vector DB
editStoringRe-embed and replace stored chunks by ID
deleteStoringDelete stored chunks by ID
retrieveRetrievalRetrieve chunks relevant to a query
ingestPipelineRun ingestion → chunk → embed → store in one command
queryPipelineRun query embedding → retrieval in one command
chatChatRun a RAG chat turn, or start the interactive chat REPL

​
Stage-based workflow

Stage commands pass data through JSON files, giving you full control over each step. 
ragrails scrape https://example.com/docs --output-dir files/output/web/
ragrails chunk --input-dir files/output/web/ --output-dir files/chunks/
ragrails embed --input-dir files/chunks/ --output-dir files/embedded/ --provider voyage --model voyage-3
ragrails store --input-dir files/embedded/ --vector-db qdrant --collection docs --url http://localhost:6333
ragrails retrieve "How do I authenticate?" --vector-db qdrant --collection docs --url http://localhost:6333 --provider voyage --model voyage-3

​
One-command pipeline

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