How jainamd05/marketsim works
MarketSim AI turns a branching business questionnaire into an evidence-backed market analysis and strategy report. Users review a business profile, choose demo or live research, and start an analysis; backend agents gather market evidence, draft strategies, simulate financial outcomes, critique assumptions, and produce a report for dashboard exploration and zero-search-credit what-if runs. The graph follows documented workflow relationships and sampled call sites; most agent internals and several frontend-to-API call sites were not sampled, so those links rely on README statements rather than inspected implementation.
Main entry points: graph.py Agent workflow · analysis_service.py Analysis service · gateway.py Search gateway · routes.py API routes
Components 27
User experience
- Profile onboarding
frontend/src/features/onboarding/OnboardingWizard.tsx - Profile review
frontend/src/features/onboarding/ReviewPage.tsx - Analysis dashboard
frontend/src/features/dashboard - Frontend API client
frontend/src/lib/api.ts
API and orchestration
- API routes
backend/app/api/routes.py - Analysis service
backend/app/services/analysis_service.py - Agent workflow
backend/app/agents/graph.py - Agent runtime
backend/app/agents/runtime.py
Market research
- Research planner
backend/app/agents/planner.py - Market intelligence
backend/app/intelligence - Search gateway
backend/app/serpapi/gateway.py - Search adapters
backend/app/serpapi/adapters - Evidence normalization
backend/app/serpapi/normalize.py
Strategy and simulation
- Strategy builder
backend/app/agents/strategy_builder.py - LLM strategy drafts
backend/app/agents/llm_strategy.py - Financial simulation
backend/app/simulation/engine.py - Strategy critic
backend/app/agents/critic.py - Report composer
backend/app/agents/report.py
Data and integrations
- LLM adapter
backend/app/llm/adapter.py - SQLite persistence
backend/app/db.py - Stored analysis models
backend/app/models.py - Business profile schema
backend/app/schemas/profile.py - Analysis schemas
backend/app/schemas/analysis.py - Demo fixtures
backend/app/serpapi/synthetic.py
Other components
- Entrepreneur
- SerpApi
- LLM providers
Connections 29
- Entrepreneur → Profile onboarding: answers questions
- Profile onboarding → Profile review: reviews profile
- Profile review → Frontend API client: saves and starts
- Frontend API client → API routes: calls API
- API routes → Analysis service: creates analysis
backend/app/api/routes.py - Analysis service → Agent workflow: invokes workflow
backend/app/services/analysis_service.py - Agent workflow → Research planner: plans research
- Agent workflow → Market intelligence: gathers evidence
- Market intelligence → Search gateway: requests searches
- Search gateway → Search adapters: dispatches engines
- Search gateway → SerpApi: queries
- Search gateway → Demo fixtures: loads fixtures
backend/app/serpapi/gateway.py - Search adapters → Evidence normalization: normalizes results
backend/app/serpapi/adapters/search.py - Agent workflow → Strategy builder: builds strategies
- Strategy builder → LLM strategy drafts: drafts optionally
backend/app/agents/llm_strategy.py - LLM strategy drafts → LLM adapter: requests structured output
backend/app/agents/llm_strategy.py - LLM adapter → LLM providers: requests completion
backend/app/llm/adapter.py - Agent workflow → Financial simulation: simulates strategies
- Analysis service → Financial simulation: serves what-if runs
backend/app/api/routes.py - Agent workflow → Strategy critic: challenges assumptions
- Agent workflow → Report composer: composes report
- Analysis service → Agent runtime: builds runtime
backend/app/services/analysis_service.py - Analysis service → SQLite persistence: persists results
backend/app/services/analysis_service.py - API routes → SQLite persistence: reads and writes
backend/app/api/routes.py - SQLite persistence → Stored analysis models: stores records
- Profile onboarding → Business profile schema: collects profile data
- Agent workflow → Analysis schemas: exchanges typed results
- Report composer → Analysis dashboard: presents results
- Analysis dashboard → API routes: loads results and events