All notable changes to the CAG System will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- BREAKING: Reorganized project structure to follow professional src-layout
- Moved all source code to
src/cag/package - Organized code into
api/,core/,services/, andui/modules - Updated all import statements to use new package structure
- Updated Docker and deployment configurations
- Moved all source code to
- Updated
pyproject.tomlto use src-layout - Updated entry points in
main.pyandapp_gradio.py
- Comprehensive documentation in
docs/directoryARCHITECTURE.md: System architecture and design patternsSETUP.md: Detailed setup and installation guideAPI.md: Complete API reference documentation
CONTRIBUTING.md: Contribution guidelinesCHANGELOG.md: This file- Professional directory structure with proper separation of concerns
- Import paths now follow Python packaging best practices
- Module organization improves code maintainability
- Initial release of CAG (Cache Augmentation Generation) System
- FastAPI REST API with document upload and query endpoints
- Gradio web interface for interactive usage
- Intelligent caching with LRU eviction and semantic similarity
- Document processing for PDF, TXT, and MD files
- Vector store integration with ChromaDB
- Google Gemini 2.5 Flash Lite integration
- Docker and Docker Compose support
- Comprehensive test suite
- Redis support for distributed caching
- Prometheus and Grafana monitoring (optional)
- Multi-format document support (PDF, TXT, MD)
- Smart text chunking with overlap
- Semantic document search
- Cache-augmented generation
- RESTful API with OpenAPI documentation
- Interactive Gradio UI
- Health check endpoints
- Statistics and monitoring endpoints
- Environment-based configuration