How aayushgokhale2005/finfreedom works
FinFreedom is a stock-analysis product: users browse or search symbols, inspect market data and indicators, and receive AI recommendations; authenticated users also have protected dashboard access. The frontend calls the FastAPI service, which routes stock and insight requests through market-data, caching, persistence, and prediction services. The repository also contains a distinct algorithm research/training and backtesting toolkit. Relationships below are limited to README statements and supplied source/index evidence; unsampled routes and frontend request wiring are not inferred.
Main entry points: stocks_v2.py Stock API routes · backend/main.py FastAPI app · finfreedom_algo/main.py Analysis orchestrator · ai_model_service.py Prediction service
Components 30
Web experience
- Pages and dashboard
frontend/src/app - Symbol details
frontend/src/app/stock/[symbol]/page.tsx - AI insights UI
frontend/src/components/AIInsights.tsx - Authentication UI
frontend/src/contexts/AuthContext.tsx - Firebase client
frontend/src/lib/firebase.ts
API and market data
- FastAPI app
backend/main.py - Stock API routes
backend/app/routes/stocks_v2.py - Auth routes
backend/app/routes/auth.py - Insight routes
backend/app/routes/ai_insights.py - Market data service
backend/app/services/stock_service.py - TTL cache and limiter
backend/app/services/cache_service.py - Symbol search index
backend/app/services/search_index.py - S&P 500 universe
backend/app/data/sp500_universe.py - User and stock data
backend/app/services/firestore_service.py - Firestore
AI analysis
- Prediction service
backend/app/services/ai_model_service.py - Recommendation service
backend/app/services/recommendation_service.py - Live market analysis
finfreedom_algo/live_data_service.py
Algorithm toolkit
- Analysis orchestrator
finfreedom_algo/main.py - Technical features
finfreedom_algo/stock_feature_calculation.py - Technical recommendations
finfreedom_algo/recommendation_system.py - Model training
finfreedom_algo/ML/model.py - Model predictions
finfreedom_algo/ML/prediction.py - Historical data fetch
finfreedom_algo/get_stock_data.py - Data cleaning
finfreedom_algo/data_cleaning.py - Model selection
finfreedom_algo/decision_maker.py - Probabilistic trading
finfreedom_algo/probabilistic_trading.py - Evaluation workflow
finfreedom_algo/eval_results.py - Backtesting
finfreedom_algo/backtesting.py
Other components
- Stock user
Connections 37
- Stock user → Pages and dashboard: browses
README.md - Pages and dashboard → Symbol details: opens symbols
README.md - Pages and dashboard → Authentication UI: authenticates
README.md - Symbol details → Stock API routes: requests stock data
- AI insights UI → Insight routes: requests insights
- Authentication UI → Firebase client: uses auth client
- FastAPI app → Stock API routes: registers router
backend/main.py - FastAPI app → Auth routes: registers router
backend/main.py - FastAPI app → Insight routes: registers router
backend/main.py - FastAPI app → Symbol search index: initializes
backend/main.py - FastAPI app → S&P 500 universe: loads tickers
backend/main.py - Stock API routes → Market data service: calls
backend/app/routes/stocks_v2.py - Stock API routes → TTL cache and limiter: uses
backend/app/routes/stocks_v2.py - Stock API routes → User and stock data: calls
backend/app/routes/stocks_v2.py - Stock API routes → Prediction service: requests predictions
backend/app/routes/stocks_v2.py - Stock API routes → S&P 500 universe: uses ticker list
backend/app/routes/stocks_v2.py - Market data service → TTL cache and limiter: reads and writes
backend/app/services/stock_service.py - User and stock data → Firestore: reads and writes
- Prediction service → Evaluation workflow: uses analysis
backend/app/services/ai_model_service.py - Prediction service → Probabilistic trading: uses models
backend/app/services/ai_model_service.py - Prediction service → Model selection: uses selection
backend/app/services/ai_model_service.py - Recommendation service → Live market analysis: requests live data
backend/app/services/recommendation_service.py - Analysis orchestrator → Technical features: computes features
finfreedom_algo/main.py - Analysis orchestrator → Technical recommendations: generates recommendation
finfreedom_algo/main.py - Analysis orchestrator → Model predictions: runs predictions
finfreedom_algo/main.py - Analysis orchestrator → Model training: integrates models
finfreedom_algo/main.py - Technical recommendations → Technical features: uses
finfreedom_algo/recommendation_system.py - Technical recommendations → Live market analysis: uses
finfreedom_algo/recommendation_system.py - Model training → Data cleaning: preprocesses with
finfreedom_algo/ML/model.py - Model training → Historical data fetch: loads data via
finfreedom_algo/ML/model.py - Model predictions → Historical data fetch: loads data via
finfreedom_algo/ML/prediction.py - Evaluation workflow → Historical data fetch: loads data via
finfreedom_algo/eval_results.py - Evaluation workflow → Probabilistic trading: uses predictions
finfreedom_algo/eval_results.py - Evaluation workflow → Model selection: selects model
finfreedom_algo/eval_results.py - Backtesting → Data cleaning: uses
finfreedom_algo/backtesting.py - Backtesting → Probabilistic trading: uses
finfreedom_algo/backtesting.py - Backtesting → Model selection: uses
finfreedom_algo/backtesting.py