Vector Databases

Ragrails stores embedded chunks in a vector database. Use the same provider, collection, and URL when you store, retrieve, query, or chat over the same knowledge base.

Supported Providers

Provider	Use this value	Install extra	Default URL	Default collection	Notes
Qdrant local	`qdrant`	`ragrails[qdrant]` or `ragrails[store-qdrant]`	`http://localhost:6333`	`rag_chunks`	Good local default and quickstart path
Qdrant Cloud	`qdrant_cloud`	`ragrails[qdrant]` or `ragrails[store-qdrant]`	none	`rag_chunks`	Set `url` to your cloud endpoint and `QDRANT_API_KEY`
Pinecone	`pinecone`	`ragrails[pinecone]` or `ragrails[store-pinecone]`	none	`rag-chunks`	Uses `PINECONE_API_KEY`
Weaviate	`weaviate`	`ragrails[weaviate]` or `ragrails[store-weaviate]`	`http://localhost:8080`	`RagChunks`	Works with local or hosted Weaviate

Where The Name Goes

from ragrails import RagRails

rag = RagRails(
    collection="support",
    vector_store={"provider": "qdrant", "url": "http://localhost:6333"},
)

ragrails query "refund policy" \
  --vector-db qdrant \
  --collection support \
  --url http://localhost:6333

{
  "vector_db": "qdrant",
  "collection": "support",
  "url": "http://localhost:6333"
}

The SDK constructor uses vector_store={"provider": ...}. CLI and REST use vector_db for the same provider name.

Local Qdrant

The quickstarts use local Qdrant because it is easy to run in Docker:

docker run -p 6333:6333 qdrant/qdrant

Use this target in examples:

provider: qdrant
url: http://localhost:6333
collection: support

Cloud Providers

Cloud vector databases usually require an API key in the environment plus provider-specific setup in the hosted service.

Provider	Environment variable
Qdrant Cloud	`QDRANT_API_KEY`
Pinecone	`PINECONE_API_KEY`
Weaviate	`WEAVIATE_API_KEY`

Keep API keys in environment variables, not in .ragrails.toml or request examples.

Reference

Development

Supported Providers

Where The Name Goes

Local Qdrant

Cloud Providers

​Supported Providers

​Where The Name Goes

​Local Qdrant

​Cloud Providers

​Related Pages

Supported Providers

Where The Name Goes

Local Qdrant

Cloud Providers

Related Pages