Graph RAG: LightRAG Integration
LightRAG is a managed knowledge backend that builds a knowledge graph from your documents.
LightRAG is a managed knowledge backend that builds a knowledge graph from your documents. It handles its own ingestion and retrieval, providing graph-based RAG capabilities.
"""
Graph RAG: LightRAG Integration
=================================
LightRAG is a managed knowledge backend that builds a knowledge graph
from your documents. It handles its own ingestion and retrieval,
providing graph-based RAG capabilities.
Unlike standard vector-based RAG, LightRAG:
- Extracts entities and relationships from documents
- Builds a knowledge graph for multi-hop reasoning
- Supports graph-traversal queries
Requirements: pip install lightrag-agno
"""
import asyncio
from agno.agent import Agent
from agno.knowledge.knowledge import Knowledge
from agno.models.openai import OpenAIResponses
# ---------------------------------------------------------------------------
# Setup
# ---------------------------------------------------------------------------
try:
from agno.vectordb.lightrag import LightRag
knowledge = Knowledge(
vector_db=LightRag(
server_url="http://localhost:9621",
),
)
agent = Agent(
model=OpenAIResponses(id="gpt-5.2"),
knowledge=knowledge,
search_knowledge=True,
markdown=True,
)
except ImportError:
knowledge = None
agent = None
print("LightRAG not installed. Run: pip install lightrag-agno")
# ---------------------------------------------------------------------------
# Run Demo
# ---------------------------------------------------------------------------
if __name__ == "__main__":
async def main():
if knowledge and agent:
await knowledge.ainsert(
url="https://agno-public.s3.amazonaws.com/recipes/ThaiRecipes.pdf"
)
print("\n" + "=" * 60)
print("Graph RAG: knowledge graph-based retrieval")
print("=" * 60 + "\n")
agent.print_response(
"What ingredients are commonly shared across Thai recipes?",
stream=True,
)
asyncio.run(main())The Agno adapter talks to a separately running LightRAG HTTP server. Follow the installation steps below; the retained source’s lightrag-agno install hint is stale. The local server has its own model and embedding configuration.
Run the Example
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activateInstall dependencies
uv pip install -U agno "lightrag-hku[api]" beautifulsoup4 openai pypdfExport your OpenAI API key
export OPENAI_API_KEY="your_openai_api_key_here"Start LightRAG
Configure LightRAG's LLM and embedding settings in .env, then start the API server on port 9621. See the LightRAG API server guide. Keep the server running:
lightrag-server --port 9621Run the example
Save the code above as graph_rag.py, then run:
python graph_rag.pyFull source: cookbook/07_knowledge/04_advanced/03_graph_rag.py