How mustafaahmed007/adaptiverag-x works
AdaptiveRAG-X is a local-first adaptive RAG platform. A user submits a query through the HTTP API; security checks and planning guide retrieval, evidence evaluation and bounded rewrites, then grounded generation returns an answer with citations and trace metadata. Separate capabilities handle document ingestion, multi-aspect research, durable storage, and operational evaluation. The pipeline and core retriever implementations are excerpted; several other relationships and the API’s internal routing are supported only by README or source-index references, so those links are limited accordingly.
Main entry points: pipeline.py Adaptive pipeline · api.py HTTP API · hybrid.py Hybrid retrieval · services.py Ingestion and chunking
Components 23
API and access
- HTTP API
adaptive_rag/api.py - API middleware
adaptive_rag/middleware.py
Query orchestration
- Domain contracts
adaptive_rag/models.py - Adaptive pipeline
adaptive_rag/pipeline.py - Security gate
adaptive_rag/security.py - Query planner
adaptive_rag/planner.py - Rewrite and citations
adaptive_rag/query.py - Answer generation
adaptive_rag/providers.py
Evidence retrieval
- Hybrid retrieval
adaptive_rag/retrieval/hybrid.py - Local retrieval
adaptive_rag/retrieval/memory.py - BM25 retrieval
adaptive_rag/retrieval/sparse.py - Graph retrieval
adaptive_rag/retrieval/graph.py - Web retrieval
adaptive_rag/retrieval/web.py - Evidence reranker
adaptive_rag/retrieval/rerank.py - Qdrant adapter
adaptive_rag/retrieval/qdrant.py - Embedding providers
adaptive_rag/embeddings.py
Content and research
- Ingestion and chunking
adaptive_rag/services.py - Document storage
adaptive_rag/storage.py - Multi-aspect research
adaptive_rag/research.py
Quality and operations
- Evidence evaluation
adaptive_rag/evaluation.py - Trace and costs
adaptive_rag/observability.py - Quality metrics
adaptive_rag/evaluation.py
Other components
- User
Connections 24
- User → HTTP API: submits query
README.md - HTTP API → API middleware: uses access controls
adaptive_rag/api.py - HTTP API → Adaptive pipeline: routes queries
adaptive_rag/api.py - HTTP API → Multi-aspect research: routes research
adaptive_rag/api.py - HTTP API → Ingestion and chunking: uses ingestion
adaptive_rag/api.py - Adaptive pipeline → Security gate: checks query
adaptive_rag/pipeline.py - Adaptive pipeline → Query planner: builds plan
adaptive_rag/pipeline.py - Adaptive pipeline → Rewrite and citations: rewrites and cites
adaptive_rag/pipeline.py - Adaptive pipeline → Answer generation: generates answer
adaptive_rag/pipeline.py - Adaptive pipeline → Hybrid retrieval: retrieves evidence
adaptive_rag/pipeline.py - Adaptive pipeline → Graph retrieval: retrieves multi-hop
adaptive_rag/pipeline.py - Adaptive pipeline → Web retrieval: retrieves fresh evidence
adaptive_rag/pipeline.py - Adaptive pipeline → Evidence reranker: reranks evidence
adaptive_rag/pipeline.py - Adaptive pipeline → Evidence evaluation: evaluates evidence
adaptive_rag/pipeline.py - Adaptive pipeline → Trace and costs: records trace
adaptive_rag/pipeline.py - Hybrid retrieval → Local retrieval: queries dense side
adaptive_rag/pipeline.py - Hybrid retrieval → BM25 retrieval: queries sparse side
adaptive_rag/pipeline.py - Ingestion and chunking → Domain contracts: creates documents
adaptive_rag/services.py - Multi-aspect research → Ingestion and chunking: ingests report sources
adaptive_rag/research.py - Qdrant adapter → Embedding providers: embeds content
adaptive_rag/retrieval/qdrant.py - Adaptive pipeline → Qdrant adapter: may use adapter
README.md - Adaptive pipeline → Document storage: may persist documents
README.md - Adaptive pipeline → Domain contracts: returns response
adaptive_rag/pipeline.py - HTTP API → Domain contracts: uses request models
adaptive_rag/api.py