codebaserag — ingestion, retrieval and evaluation

codebaserag — ingestion, retrieval and evaluation An architecture diagram generated by Archify. Developer / client · CLI or HTTP · Architecture component Developer / client CLI or HTTP CLI + FastAPI · ingest · query · answer · eval · Architecture component CLI + FastAPI ingest · query · answer · eval Composition root · build_retriever · build_serving_components · Architecture component Composition root build_retriever · build_serving_components Ingest pipeline · discover → chunk → embed → upsert · Architecture component Ingest pipeline discover → chunk → embed → upsert Retriever · dense · hybrid · hybrid+rerank · Architecture component Retriever dense · hybrid · hybrid+rerank Dense store (VectorStore port) · memory · pgvector · Qdrant · LlamaIndex · Architecture component Dense store (VectorStore port) memory · pgvector · Qdrant · LlamaIndex BM25 index · memory · Postgres FTS · Tantivy · Architecture component BM25 index memory · Postgres FTS · Tantivy RRF fusion + rerank · RRF; optional rerank · Architecture component RRF fusion + rerank RRF; optional rerank Embedder service · Ollama / llama.cpp · Architecture component Embedder service Ollama / llama.cpp Generator · structured answer + citations · Architecture component Generator structured answer + citations LLM service · LiteLLM / fake · Architecture component LLM service LiteLLM / fake Eval harness · recall@k · MRR · nDCG · baseline gate · Architecture component Eval harness recall@k · MRR · nDCG · baseline gate Golden set + baseline · evals/golden · baseline.json · Architecture component Golden set + baseline evals/golden · baseline.json command / HTTP build ingest query / answer embed chunks upsert embed query top-k vectors top-k terms dense + lexical retrieved context structured prompt runs queries loads Q/A + baseline Legend Backend Database Cloud External