Skip to content

StockSage

Local-first, multi-agent stock analysis. Enter a ticker → get a full investment report in minutes — valuation, performance, financial health, sentiment, and a final verdict — all streamed live to your browser.

You bring your own model (Ollama, OpenAI, Gemini, DeepSeek, Groq, Anthropic). No cloud account required to run locally.

Not financial advice

Output is generated by LLMs and may be inaccurate. Never make investment decisions based solely on this tool.

Quickstart

# 1. Clone and install
git clone https://github.com/kanishk-varshney/StockSage.git
cd StockSage
uv sync

# 2. Configure
cp .env.example .env   # set LLM_MODEL + API key

# 3. Validate config
make check

# 4. Run
make run               # opens at http://127.0.0.1:8000

Enter a symbol (AAPL, RELIANCE.NS, GOOGL) and hit Analyze.

What it does

  • Validates the ticker (US and Indian .NS/.BO formats)
  • Downloads price history, financials, benchmarks, news, Google Trends, insider transactions, and institutional holders — saved as CSVs
  • Runs a 7-agent CrewAI pipeline sequentially: data sanity → valuation → performance → financial health → sentiment → cross-agent review → final verdict
  • Streams every step live to the browser via SSE
  • Renders structured cards with a final BUY / HOLD / SELL verdict and confidence level