How hetpatel1978/aksibu_mini works
Aksibu Mini is an engineering context engine with two distinct question-answering workflows: GraphRAG over normalized engineering records, and separately indexed document search with validated citations. The documented flow runs from index building through retrieval to Streamlit results; a health dashboard exposes index and graph status. Major document-search and dashboard capabilities are retained, though some implementation details were not sampled, so uncertain relationships are omitted.
Main entry points: main.py Index Builder · doc_search.py Document Search UI · agent.py Retrieval Agent · doc_store.py Document Index
Components 17
Engineering Context
- Graph Builder
graph/graph_builder.py - Knowledge Graph
graph/graph_builder.py - Graph Traversal
graph/graph_query.py - Engineering Vector Index
index/vector_store.py - Retrieval Agent
retrieval/agent.py
Document Search
- Document Chunker
ingestion/doc_chunker.py - Document Index
index/doc_store.py - Cited Retrieval
retrieval/cited_retriever.py
Streamlit Interface
- Engineering Chat
ui/app.py - Health Dashboard
ui/pages/health.py - Document Search UI
ui/pages/doc_search.py
Index Construction
- Index Builder
main.py - Sample Data
mock_data_generator.py - Record Normalizer
ingestion/normalizer.py - Rule Extraction
ingestion/rule_extractor.py - Tiered Extraction
ingestion/tiered_extractor.py
Other components
- Engineer
Connections 20
- Engineer → Index Builder: builds index
README.md - Index Builder → Sample Data: generates data
main.py - Index Builder → Record Normalizer: normalizes records
main.py - Index Builder → Graph Builder: builds graph
main.py - Index Builder → Engineering Vector Index: indexes records
main.py - Index Builder → Tiered Extraction: extracts entities
- Tiered Extraction → Rule Extraction: uses rules
ingestion/tiered_extractor.py - Graph Builder → Knowledge Graph: constructs
graph/graph_builder.py - Engineer → Engineering Chat: asks question
README.md - Engineering Chat → Retrieval Agent: runs query
ui/app.py - Retrieval Agent → Engineering Vector Index: searches records
retrieval/agent.py - Retrieval Agent → Graph Traversal: dispatches tools
retrieval/agent.py - Engineer → Health Dashboard: checks status
README.md - Health Dashboard → Engineering Vector Index: reads stats
ui/pages/health.py - Engineer → Document Search UI: uploads or asks
README.md - Document Search UI → Document Chunker: chunks uploads
ui/pages/doc_search.py - Document Search UI → Document Index: ingests folders
ui/pages/doc_search.py - Document Index → Document Chunker: chunks folder files
index/doc_store.py - Document Search UI → Cited Retrieval: requests answers
ui/pages/doc_search.py - Cited Retrieval → Document Index: retrieves chunks
retrieval/cited_retriever.py