victor-rag
RAG (Retrieval-Augmented Generation) Vertical for Victor AI
A complete RAG implementation showcasing document ingestion, vector search, and knowledge management with Victor AI.
Features
-
📄 Multi-format Document Ingestion
- PDF, Markdown, Text, Code files
- Semantic chunking with configurable overlap
- Automatic document type detection
-
🔍 Hybrid Search
- Vector search (semantic similarity)
- Full-text search (keyword matching)
- Combined reranking for best results
-
💾 Embedded Vector Storage
- LanceDB (no server required)
- Persistent local storage
- Fast similarity search
-
🎯 Query Enhancement
- Context retrieval from relevant documents
- Source attribution and citations
- Confidence scoring
Installation
# Install with Victor core
pip install victor-ai
# Install RAG vertical
pip install victor-rag
Quick Start
from victor.framework import Agent
# Create agent with RAG vertical
agent = await Agent.create(
provider="ollama",
model="qwen2.5-coder:7b",
vertical="rag"
)
# Ingest a document
await agent.chat("Ingest README.md into the knowledge base")
# Query the knowledge base
result = await agent.chat("What does this project do?")
Available Tools
Once installed, the RAG vertical provides these tools:
- rag_ingest - Ingest documents into the knowledge base
- rag_search - Search for relevant document chunks
- rag_query - Query with context retrieval
- rag_list - List all indexed documents
- rag_delete - Delete documents from knowledge base
- rag_stats - Get knowledge base statistics
System Prompt
The RAG vertical includes specialized prompt contributions:
- Query Strategy: When to use semantic vs keyword search
- Citation Format: How to reference sources
- Document Handling: Chunking strategies by document type
- Quality Rules: Grounding rules to prevent hallucination
Configuration
The RAG vertical can be configured via environment variables:
# Vector store location
export VICTOR_RAG_DB_PATH=./rag_db
# Chunking configuration
export VICTOR_RAG_CHUNK_SIZE=512
export VICTOR_RAG_CHUNK_OVERLAP=50
# Search configuration
export VICTOR_RAG_TOP_K=5
export VICTOR_RAG_MIN_CONFIDENCE=0.3
Development
# Install with dev dependencies
pip install -e ".[dev]"
# Run tests
pytest tests/
# Format code
black victor_rag/
# Type check
mypy victor_rag/
License
Apache License 2.0 - see LICENSE for details.
Links
- Victor AI: https://github.com/vjsingh1984/victor
- Documentation: https://docs.victor.dev/verticals/rag
- Victor Registry: https://github.com/vjsingh1984/victor-registry
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file victor_rag-0.7.1.tar.gz.
File metadata
- Download URL: victor_rag-0.7.1.tar.gz
- Upload date:
- Size: 100.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7eb3486eb4c0399e0fd82bcc84f7cf32551b514947d14179294f3bde024a7947
|
|
| MD5 |
32b13a12c51f64aeefa372773c91caaf
|
|
| BLAKE2b-256 |
93317c7f816b275f525531c17724c58990fd2529b48f0b0b064c18d81f67ca85
|
Provenance
The following attestation bundles were made for victor_rag-0.7.1.tar.gz:
Publisher:
release-verticals.yml on vjsingh1984/victor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
victor_rag-0.7.1.tar.gz -
Subject digest:
7eb3486eb4c0399e0fd82bcc84f7cf32551b514947d14179294f3bde024a7947 - Sigstore transparency entry: 2093509340
- Sigstore integration time:
-
Permalink:
vjsingh1984/victor@46ad0a65923175c9a760edfa14f1332a56a6bb3b -
Branch / Tag:
refs/tags/verticals-v0.7.1 - Owner: https://github.com/vjsingh1984
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-verticals.yml@46ad0a65923175c9a760edfa14f1332a56a6bb3b -
Trigger Event:
push
-
Statement type:
File details
Details for the file victor_rag-0.7.1-py3-none-any.whl.
File metadata
- Download URL: victor_rag-0.7.1-py3-none-any.whl
- Upload date:
- Size: 117.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fe2943c562682d920cdb1eb53c1f638cbb76222efc92f2fc308455be62b47bfe
|
|
| MD5 |
fe310ce6378eebe80b6aa4a1275fa743
|
|
| BLAKE2b-256 |
1d51050058cad3ff2a4b96f44205a4c7ce3ffef48c4be93992074f97df4f4295
|
Provenance
The following attestation bundles were made for victor_rag-0.7.1-py3-none-any.whl:
Publisher:
release-verticals.yml on vjsingh1984/victor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
victor_rag-0.7.1-py3-none-any.whl -
Subject digest:
fe2943c562682d920cdb1eb53c1f638cbb76222efc92f2fc308455be62b47bfe - Sigstore transparency entry: 2093509627
- Sigstore integration time:
-
Permalink:
vjsingh1984/victor@46ad0a65923175c9a760edfa14f1332a56a6bb3b -
Branch / Tag:
refs/tags/verticals-v0.7.1 - Owner: https://github.com/vjsingh1984
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-verticals.yml@46ad0a65923175c9a760edfa14f1332a56a6bb3b -
Trigger Event:
push
-
Statement type:
