How nandar-zaw/marketmind works
MarketMind is a stock-analysis web app: a user submits a ticker and horizon through the dashboard or API, then receives a BUY/HOLD/SELL recommendation, confidence, and reasoning. The Coordinator validates the request, fetches shared data, collects Technical, Sentiment, and Fundamental signals, obtains a Risk assessment, and combines the results. The dashboard also presents charts and audit checks. README documentation establishes major integrations and capabilities; some agent and service implementations were not sampled, so their documented links are shown without implying additional internal calls.
Main entry points: coordinator_agent.py Coordinator · data_agent.py Data Agent · ui.py Dashboard · schemas.py Data Schemas
Components 19
Analysis
- Coordinator
app/agents/coordinator_agent.py - Technical Agent
app/agents/technical_agent.py - Sentiment Agent
app/agents/sentiment_agent.py - Fundamental Agent
app/agents/fundamental_agent.py - Risk Manager
app/agents/risk_agent.py
Data Sources
- Data Agent
app/agents/data_agent.py - Market Data
app/services/market_data.py - News Data
app/services/news_data.py - Filings Data
app/services/filings_data.py
Shared Support
- Guardrails
app/guardrails.py - Data Schemas
app/models/schemas.py - Agent Interface
app/agents/base_agent.py - Symbol Resolver
app/utils/symbols.py - Data Errors
app/utils/exceptions.py
Other components
- Analyst
- Yahoo Finance
- OpenAI Services
Connections 24
- Analyst → API: submits ticker
README.md - Analyst → Dashboard: analyzes ticker
README.md - API → Coordinator: routes analysis
app/main.py - Dashboard → Coordinator: runs analysis
app/ui.py - Coordinator → Guardrails: checks inputs
app/agents/coordinator_agent.py - Coordinator → Data Agent: loads shared data
app/agents/coordinator_agent.py - Coordinator → Technical Agent: requests signal
app/agents/coordinator_agent.py - Coordinator → Sentiment Agent: requests signal
app/agents/coordinator_agent.py - Coordinator → Fundamental Agent: requests signal
app/agents/coordinator_agent.py - Coordinator → Risk Manager: requests risk review
app/agents/coordinator_agent.py - Coordinator → Guardrails: checks outputs
app/agents/coordinator_agent.py - Coordinator → Data Schemas: uses result types
app/agents/coordinator_agent.py - Dashboard → Data Schemas: uses result types
app/ui.py - Data Agent → Market Data: fetches prices
app/agents/data_agent.py - Data Agent → News Data: fetches headlines
app/agents/data_agent.py - Data Agent → Filings Data: retrieves filings
app/agents/data_agent.py - Data Agent → Data Schemas: builds data result
app/agents/data_agent.py - Data Agent → Symbol Resolver: normalizes ticker
app/agents/data_agent.py - Data Agent → Data Errors: raises data errors
app/agents/data_agent.py - Market Data → Yahoo Finance: fetches market data
README.md - News Data → Yahoo Finance: searches headlines
README.md - Filings Data → OpenAI Services: searches filing store
README.md - Sentiment Agent → OpenAI Services: scores headlines
README.md - Fundamental Agent → OpenAI Services: scores excerpts
README.md