How aru911-gethu/ragkitchen works
RAG Kitchen combines an interactive RAG strategy lab with a recipe assistant that runs a saved pipeline. Users can ingest PDF or web sources, compare chunking and retrieval strategies, transform queries, apply graph-based constraint filtering or deterministic graph traversal, and generate answers; evaluation measures retrieval safety and generation quality. The graph preserves these documented capabilities. Some implementation details are unsampled, so their connections are shown only where the README or source index supports them.
Main entry points: pipeline.py Pipeline configuration and execution · api.py REST and SSE API · 3_Kitchen.py Recipe assistant · traverse.py Graph traversal
Components 21
User interfaces
- REST and SSE API
src/cognitive_kitchen/api.py - RAG strategy lab
src/cognitive_kitchen/ui/pages/2_RAG_Lab.py - Recipe assistant
src/cognitive_kitchen/ui/pages/3_Kitchen.py
Ingestion and corpus
- PDF ingestion
src/cognitive_kitchen/ingest/pdf_ingest.py - Web ingestion
src/cognitive_kitchen/ingest/web_ingest.py - Ingestion jobs
src/cognitive_kitchen/jobs.py - Corpus and loaders
src/cognitive_kitchen/rag/corpus.py
RAG pipeline
- Pipeline configuration and execution
src/cognitive_kitchen/rag/pipeline.py - Chunking strategies
src/cognitive_kitchen/rag/chunking - Retrieval strategies
src/cognitive_kitchen/rag/retrieval - Query transformations
src/cognitive_kitchen/rag/query - Answer generation
src/cognitive_kitchen/rag/strategies/generation.py - Plugin registry
src/cognitive_kitchen/rag/registry.py
Knowledge graph
- Graph constraint filtering
src/cognitive_kitchen/rag/graph/constraints.py - Graph traversal
src/cognitive_kitchen/rag/graph/traverse.py - Neo4j
src/cognitive_kitchen/rag/graph/client.py - Ingredient vocabulary
src/cognitive_kitchen/rag/vocab/ingredients.py
Evaluation and observability
- RAG evaluation
src/cognitive_kitchen/rag/eval - Golden dataset
src/cognitive_kitchen/rag/eval/golden.py - Run telemetry
src/cognitive_kitchen/rag/telemetry.py
Other components
- User
Connections 25
- User → REST and SSE API: sends requests
README.md - User → RAG strategy lab: configures strategies
README.md - User → Recipe assistant: asks recipes
README.md - REST and SSE API → PDF ingestion: invokes ingestion
src/cognitive_kitchen/api.py - REST and SSE API → Web ingestion: invokes ingestion
src/cognitive_kitchen/api.py - REST and SSE API → Ingestion jobs: tracks jobs
src/cognitive_kitchen/api.py - PDF ingestion → Ingestion jobs: reports progress
src/cognitive_kitchen/ingest/pdf_ingest.py - Web ingestion → Ingestion jobs: reports progress
src/cognitive_kitchen/ingest/web_ingest.py - RAG strategy lab → Pipeline configuration and execution: builds and saves
src/cognitive_kitchen/ui/pages/2_RAG_Lab.py - Recipe assistant → Pipeline configuration and execution: loads and runs
src/cognitive_kitchen/ui/pages/3_Kitchen.py - Pipeline configuration and execution → Corpus and loaders: loads corpus
src/cognitive_kitchen/rag/pipeline.py - Pipeline configuration and execution → Chunking strategies: builds chunker
src/cognitive_kitchen/rag/pipeline.py - Pipeline configuration and execution → Retrieval strategies: builds retriever
src/cognitive_kitchen/rag/pipeline.py - Pipeline configuration and execution → Query transformations: builds transform
README.md - Pipeline configuration and execution → Answer generation: builds generator
src/cognitive_kitchen/rag/pipeline.py - Pipeline configuration and execution → Plugin registry: builds plugins
src/cognitive_kitchen/rag/pipeline.py - Retrieval strategies → Graph constraint filtering: filters constraints
src/cognitive_kitchen/rag/retrieval/graph_hybrid.py - Graph constraint filtering → Graph traversal: checks graph
src/cognitive_kitchen/rag/retrieval/graph_hybrid.py - Graph traversal → Neo4j: queries
src/cognitive_kitchen/rag/graph/traverse.py - Graph traversal → Ingredient vocabulary: canonicalizes ingredients
src/cognitive_kitchen/rag/graph/traverse.py - RAG evaluation → Golden dataset: scores against
src/cognitive_kitchen/rag/eval/golden.py - RAG evaluation → Run telemetry: records metrics
src/cognitive_kitchen/rag/telemetry.py - RAG strategy lab → RAG evaluation: benchmarks stages
src/cognitive_kitchen/ui/pages/2_RAG_Lab.py - Recipe assistant → Graph constraint filtering: applies safety constraints
src/cognitive_kitchen/ui/pages/3_Kitchen.py - Recipe assistant → Graph traversal: supports graph answers
README.md