Show HN: RAG in 3 Lines of Python
pypi.orgGot tired of wiring up vector stores, embedding models, and chunking logic every time I needed RAG. So I built piragi.
from piragi import Ragi
kb = Ragi(\["./docs", "./code/\*\*/\*.py", "https://api.example.com/docs"\])
answer = kb.ask("How do I deploy this?")
That's the entire setup. No API keys required - runs on Ollama + sentence-transformers locally.What it does:
- All formats - PDF, Word, Excel, Markdown, code, URLs, images, audio
- Auto-updates - watches sources, refreshes in background, zero query latency
- Citations - every answer includes sources
- Advanced retrieval - HyDE, hybrid search (BM25 + vector), cross-encoder reranking
- Smart chunking - semantic, contextual, hierarchical strategies
- OpenAI compatible - swap in GPT/Claude whenever you want
Quick examples: # Filter by metadata
answer = kb.filter(file_type="pdf").ask("What's in the contracts?")
#Enable advanced retrieval
kb = Ragi("./docs", config={
"retrieval": {
"use_hyde": True,
"use_hybrid_search": True,
"use_cross_encoder": True
}
})
# Use OpenAI instead
kb = Ragi("./docs", config={"llm": {"model": "gpt-4o-mini", "api_key": "sk-..."}})
Install: pip install piragi
PyPI: https://pypi.org/project/piragi/
Would love feedback. What's missing? What would make this actually useful for your projects?
Just tested it. Worked brilliantly well after fixing a minior issue.
My question: any plans on adding graph (rdf) support in near future?
Thanks..
Great documentation and dev-friendly feature set. Looks promising.
What is missing is a definition of RAG. The whole page uses this acronym like it has to be clear what it is. It is not.
Not that people can't google it, but it is just friendlier if you answer the question a good chunk of people looking at the site will have. It also allows users who need what RAG provides but don't know what it is called to discover it easier.
It’s enough for the demo to use a variable named ‘kb’, which harkens to the business logic jargon. I don’t see benefit for expanding technical jargon once the business jargon has been uttered.