How sanskrutishah14/tao-fin-capstone works
TAO-Fin is a financial question-answering API. Users submit a question; the TAO orchestrator classifies it, retrieves filing evidence, may use deterministic financial calculations or an LLM, and verifies the answer before returning it. A separate company-sync workflow ingests SEC filings and market data for indexing and lookup. The graph preserves the README’s documented retrieval, parsing, market-data, and FinanceBench capabilities; relationships involving unsampled implementations are cited to the README rather than inferred from names.
Main entry points: main.py FastAPI application · tao_pipeline.py TAO orchestrator · company_service.py Company sync · hybrid_retriever.py Hybrid retrieval
Components 29
API and orchestration
- FastAPI application
backend/app/main.py - Analysis endpoint
backend/app/routes/analyze.py - TAO orchestrator
backend/app/services/tao_pipeline.py - TAO controller
backend/app/services/tao_controller.py - Company routes
backend/app/routes/companies.py - Market routes
backend/app/routes/market.py
Filing and market data
- Company sync
backend/app/services/company_service.py - SEC filing client
backend/app/services/sec_client.py - Filing parser
backend/app/services/sec_parser.py - Document chunker
backend/app/services/chunker.py - Table extractor
backend/app/services/table_parser.py - Market data
backend/app/services/market_data.py - Finance database
backend/app/db/models.py
Evidence retrieval
- RAG pipeline
backend/app/services/rag_pipeline.py - Hybrid retrieval
backend/app/services/hybrid_retriever.py - Embeddings
backend/app/services/embeddings.py - FAISS vector store
backend/app/services/vector_store.py - BM25 index
backend/app/services/bm25_index.py - Cross-encoder reranker
backend/app/services/reranker.py
Reasoning and verification
- Query analyzer
backend/app/services/query_analyzer.py - Metrics resolver
backend/app/services/metrics_resolver.py - Calculator
backend/app/services/calculator.py - Ollama client
backend/app/services/ollama_client.py - Answer verifier
backend/app/services/verifier.py
Benchmark evaluation
- FinanceBench evaluator
evaluation/financebench_evaluator.py
Other components
- Questioner
- Yahoo Finance
- Ollama service
- FinanceBench dataset
Connections 33
- Questioner → FastAPI application: submits question
README.md - FastAPI application → Analysis endpoint: routes request
backend/app/main.py - Analysis endpoint → TAO orchestrator: runs analysis
README.md - TAO orchestrator → Query analyzer: classifies query
README.md - TAO orchestrator → RAG pipeline: requests evidence
backend/app/services/tao_pipeline.py - RAG pipeline → Hybrid retrieval: retrieves evidence
backend/app/services/rag_pipeline.py - Hybrid retrieval → Embeddings: embeds query
backend/app/services/hybrid_retriever.py - Hybrid retrieval → FAISS vector store: searches vectors
backend/app/services/hybrid_retriever.py - Hybrid retrieval → BM25 index: searches keywords
README.md - Hybrid retrieval → Cross-encoder reranker: reranks candidates
backend/app/services/hybrid_retriever.py - TAO orchestrator → Metrics resolver: resolves metrics
backend/app/services/tao_pipeline.py - Metrics resolver → Calculator: computes ratios
backend/app/services/metrics_resolver.py - TAO orchestrator → Ollama client: generates answer
README.md - Ollama client → Ollama service: sends prompt
backend/app/services/ollama_client.py - TAO orchestrator → Answer verifier: checks answer
README.md - TAO orchestrator → TAO controller: chooses next action
backend/app/services/tao_pipeline.py - TAO controller → RAG pipeline: expands retrieval
README.md - TAO controller → Ollama client: requests revision
README.md - Company routes → Company sync: syncs company
backend/app/routes/companies.py - Company sync → SEC filing client: downloads filings
README.md - Company sync → Filing parser: parses filings
README.md - Company sync → Finance database: persists records
backend/app/services/company_service.py - Company sync → Yahoo Finance: fetches company data
README.md - Market routes → Market data: requests market data
backend/app/routes/market.py - Market data → Yahoo Finance: fetches quotes
README.md - FastAPI application → Finance database: loads filing records
backend/app/main.py - FastAPI application → Document chunker: chunks filing text
backend/app/main.py - FastAPI application → Embeddings: builds embeddings
backend/app/main.py - FastAPI application → FAISS vector store: builds vector index
backend/app/main.py - FastAPI application → BM25 index: builds lexical index
backend/app/main.py - FastAPI application → Table extractor: extracts table chunks
backend/app/main.py - FinanceBench dataset → FinanceBench evaluator: supplies benchmark
README.md - FinanceBench evaluator → TAO orchestrator: evaluates answers
README.md