Skip to main content
Pipeline commands run multiple stages in one call. Use them for quick setup or when you don’t need intermediate files.

ingest

Runs ingestion → chunking → embedding → storage.
# From a document
ragrails ingest \
  --docs files/guide.pdf \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --provider voyage --model voyage-3

# From a folder
ragrails ingest \
  --folder files/docs/ \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --provider voyage --model voyage-3

# From a URL
ragrails ingest \
  --source-url https://example.com/docs \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --provider voyage --model voyage-3

# From raw markdown
ragrails ingest \
  --markdown "# Guide\n\nContent here." \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --provider voyage --model voyage-3

Options

OptionDefaultDescription
--docsnoneDocument file (repeatable)
--folderNoneFolder of documents to parse
--source-urlnoneURL to scrape (repeatable)
--api-urlNoneAPI endpoint to fetch
--markdownnoneRaw markdown string (repeatable)
--vector-dbqdrantVector DB provider
--collectionNoneCollection name
--urlNoneVector DB URL
--providervoyageEmbedding provider
--modelvoyage-3Embedding model
--batch-size64Chunks per embedding/storage batch
--chunk-size2000Max characters per chunk
--chunk-overlap200Overlap between chunks
--min-chunk-length100Minimum chunk length

query

Runs query embedding → retrieval.
ragrails query "What does the guide cover?" \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --provider voyage --model voyage-3 \
  --top-k 5

# With reranking
ragrails query "What does the guide cover?" \
  --vector-db qdrant --collection docs --url http://localhost:6333 \
  --provider voyage --model voyage-3 \
  --rerank --reranker-model rerank-2-lite --rerank-top-k 3

Options

OptionDefaultDescription
QUERYrequiredSearch query (positional)
--vector-dbqdrantVector DB provider
--collectionNoneCollection name
--urlNoneVector DB URL
--top-k10Results to retrieve
--providervoyageQuery embedding provider
--modelvoyage-3Query embedding model
--rerankoffEnable reranking
--rerankervoyageReranker provider
--reranker-modelrerank-2-liteReranker model
--rerank-top-k5Results after reranking