Skip to content

JamesCAlger/agentic-RAG

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RAG Q&A System

A comprehensive Retrieval-Augmented Generation (RAG) system for intelligent document-based question answering.

Overview

This project implements a production-ready RAG system that combines document processing, vector search, and large language models to provide accurate, context-aware answers to questions about uploaded documents.

Key Features

  • Document Processing: Support for multiple document formats (PDF, TXT, etc.)
  • Vector Search: Efficient similarity search using ChromaDB
  • LLM Integration: Flexible integration with OpenAI, Anthropic, and other providers
  • Advanced Retrieval: Query classification and optimized retrieval strategies
  • Web Interface: User-friendly UI for document upload and Q&A
  • REST API: Comprehensive API for programmatic access
  • Monitoring: Built-in telemetry and performance tracking
  • Evaluation: Integrated evaluation framework with RAGAS metrics

Project Structure

rag_system/
├── core/           # Core RAG components and orchestration
├── api/            # REST API and web server
├── services/       # Document processing, vector ops, LLM services
├── monitoring/     # Telemetry and monitoring
├── evaluation/     # Evaluation framework
├── ui/             # Web interface
├── utils/          # Utilities and helpers
└── tests/          # Test suite

Installation

  1. Clone the repository:
git clone <repository-url>
cd agent-to-agent-communication
  1. Install dependencies:
pip install -r requirements.txt
  1. Set up environment variables:
export OPENAI_API_KEY="your-api-key"

Quick Start

  1. Start the RAG server:
python -m rag_system.api.web_server
  1. Open http://localhost:8000 in your browser

  2. Upload documents and start asking questions!

Documentation

Development

Running Tests

python -m pytest rag_system/tests/

Debug Tools

  • debug_rag_flow.py - Debug the complete RAG pipeline
  • debug_vector_search.py - Debug vector search operations
  • debug_retrieval.py - Debug document retrieval

Performance

The system is optimized for:

  • Fast document processing and indexing
  • Efficient vector similarity search
  • Response caching for repeated queries
  • Batch processing capabilities
  • Concurrent request handling

License

MIT License - see LICENSE file for details.

About

Production-ready document QA system with vector search (ChromaDB), query classification, multi-LLM support (OpenAI/Anthropic), and RAGAS-based evaluation.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors