stockai

# StockAI

AI-Powered Indonesian Stock Analysis CLI - Your personal hedge fund toolkit for IDX investing.

Designed for **passive investors** with:
- 15 minutes/day
- Small capital (< Rp 10 juta)
- Systematic, data-driven approach

## Features

### Quality Over Quantity System (NEW)
- **6-Gate Decision Filter** - Only trade when ALL quality gates pass
- **Smart Money Score** - Track institutional accumulation via OBV, MFI, volume
- **Support/Resistance Detection** - Automated pivot point analysis
- **Trade Plan Generation** - Entry range, stop-loss, take-profit levels
- **3-Agent AI Validation** - Technical, Fundamental, Risk Manager review

### Core Analysis
- **Multi-Agent Trading System** - 7 specialized AI agents (Analyst, Researcher, Risk Manager, etc.)
- **Technical Analysis** - RSI, MACD, Bollinger Bands, EMA crossovers, ADX
- **Sentiment Analysis** - Gemini-powered Indonesian news analysis

### Quantitative Tools (Hedge Fund Style)
- **Multi-Factor Scoring** - Value (25%), Quality (30%), Momentum (25%), Volatility (20%)
- **Position Sizing** - Professional 2% risk rule
- **Diversification Checks** - Max 20%/stock, 40%/sector limits
- **Portfolio Risk Metrics** - VaR, Sharpe ratio, beta, max drawdown

### Daily Workflow
- **Morning Briefing** - Pre-market alerts, stop-loss warnings
- **Evening Briefing** - Daily P&L, score changes, tomorrow's focus
- **Weekly Review** - Performance vs IHSG, win rate, lessons learned

### Practice & Learning
- **Paper Trading** - Risk-free practice with virtual capital
- **Interactive Tutorials** - 8 lessons on Indonesian stock market basics
- **Quizzes** - Test your knowledge before risking real money

## Installation

```bash
# Using uv (recommended)
git clone https://github.com/rebekz/stockai.git
cd stockai
uv sync

# Or using pip
pip install -e .
```

## Quick Start

```bash
# Verify installation
uv run stockai --version

# Show all commands
uv run stockai --help
```

---

## Passive Trader Workflow (15 Minutes/Day)

Perfe