How raniaakrout/khallinetfaker works
KhalliNetfaker accepts meeting transcripts, indexes and summarizes them, then supports cited question answering through a tool-using agent. The main runtime path is upload → deduplication and processing → vector indexing and minutes → chat retrieval or summary. Separate capabilities include authentication, evaluation, and configurable benchmarking. The graph reflects the README and available excerpts; some frontend/API and benchmark wiring is documented but not visible in sampled source, so those links are documented rather than inferred from imports.
Main entry points: main.py Transcript and chat API · transcript_service.py Upload orchestration · crud.py Database operations · indexer.py Transcript indexer
Components 25
Web interface
- Chat and upload UI
transcript-upload-pipeline/components/chat-interface.tsx - Upload dialog
transcript-upload-pipeline/components/upload-modal.tsx - Benchmark interface
transcript-upload-pipeline/components/benchmark-modal.tsx - API client
transcript-upload-pipeline/lib/api.ts
API and access
- Authentication routes
meeting_rag/src/api/auth.py - Transcript and chat API
meeting_rag/src/api/main.py - JWT and password security
meeting_rag/src/utils/security.py
Transcript processing
- Upload orchestration
meeting_rag/src/services/transcript_service.py - Transcript indexer
meeting_rag/src/rag/indexer.py - Transcript loader
meeting_rag/src/loader.py - Chunking strategies
meeting_rag/src/chunker.py - Minutes summarizer
meeting_rag/src/summarizer.py - Minutes and API schemas
meeting_rag/src/schemas.py
Answering and evaluation
- LangGraph agent
meeting_rag/src/agent.py - Search and summary tools
meeting_rag/src/rag/tools.py - Chunk retrieval
meeting_rag/src/rag/retriever.py - FAISS vector store
meeting_rag/src/rag/vector_store.py - Text embeddings
meeting_rag/src/rag/embeddings.py - Quality evaluation
meeting_rag/src/evaluation - RAG benchmarking
meeting_rag/src/api
Stored data
- Database operations
meeting_rag/database/crud.py - Relational data models
meeting_rag/database/models.py - PostgreSQL
meeting_rag/database/db.py - Transcript files
meeting_rag/src/services/transcript_service.py
Other components
- Meeting user
Connections 32
- Meeting user → Chat and upload UI: uses
README.md - Chat and upload UI → Upload dialog: opens
README.md - Chat and upload UI → API client: requests
- Upload dialog → API client: uploads through
- API client → Transcript and chat API: calls API
README.md - Meeting user → Authentication routes: authenticates
README.md - Authentication routes → JWT and password security: creates tokens
meeting_rag/src/api/auth.py - Authentication routes → Database operations: looks up and creates users
meeting_rag/src/api/auth.py - JWT and password security → Database operations: loads user
meeting_rag/src/utils/security.py - Transcript and chat API → Upload orchestration: processes upload
meeting_rag/src/api/main.py - Upload orchestration → Transcript indexer: builds index
meeting_rag/src/services/transcript_service.py - Transcript indexer → Transcript loader: loads transcript
meeting_rag/src/rag/indexer.py - Transcript indexer → Chunking strategies: chunks text
meeting_rag/src/rag/indexer.py - Transcript indexer → FAISS vector store: builds vectors
meeting_rag/src/rag/indexer.py - Upload orchestration → Minutes summarizer: generates minutes
meeting_rag/src/services/transcript_service.py - Minutes summarizer → Transcript loader: loads transcript
meeting_rag/src/summarizer.py - Minutes summarizer → Chunking strategies: chunks text
meeting_rag/src/summarizer.py - Upload orchestration → Database operations: persists minutes and metadata
meeting_rag/src/services/transcript_service.py - Upload orchestration → Transcript files: writes transcript
meeting_rag/src/services/transcript_service.py - Transcript and chat API → LangGraph agent: invokes
meeting_rag/src/api/main.py - LangGraph agent → Search and summary tools: selects tools
README.md - Search and summary tools → Chunk retrieval: searches chunks
- Chunk retrieval → FAISS vector store: retrieves vectors
meeting_rag/src/rag/retriever.py - FAISS vector store → Text embeddings: uses embeddings
meeting_rag/src/rag/vector_store.py - Transcript and chat API → Database operations: saves chat
meeting_rag/src/api/main.py - Database operations → Relational data models: queries and updates
meeting_rag/database/crud.py - Relational data models → PostgreSQL: maps tables
meeting_rag/database/models.py - Transcript and chat API → Quality evaluation: runs evaluation
meeting_rag/src/api/main.py - Quality evaluation → Chunk retrieval: uses retrieved context
meeting_rag/src/evaluation/summarization_eval.py - Meeting user → Benchmark interface: configures benchmark
README.md - Benchmark interface → RAG benchmarking: starts comparison
- Transcript and chat API → RAG benchmarking: registers routes
meeting_rag/src/api/main.py