sigma-terminal 3.3.1__py3-none-any.whl → 3.4.0__py3-none-any.whl

sigma/setup.py

@@ -1,4 +1,4 @@
-"""Sigma v3.3.1 - Setup Wizard."""
+"""Sigma v3.4.0 - Setup Wizard."""
 
 import os
 import sys
@@ -25,20 +25,20 @@ from .config import (
 )
 
 
-__version__ = "3.3.1"
+__version__ = "3.4.0"
 SIGMA = "σ"
 console = Console()
 
-# Clean banner - just SIGMA, no SETU
+# Clean banner - just SIGMA
 BANNER = """
-[bold blue]███████╗██╗ ██████╗ ███╗   ███╗ █████╗ [/bold blue]
-[bold blue]██╔════╝██║██╔════╝ ████╗ ████║██╔══██╗[/bold blue]
-[bold blue]███████╗██║██║  ███╗██╔████╔██║███████║[/bold blue]
-[bold blue]╚════██║██║██║   ██║██║╚██╔╝██║██╔══██║[/bold blue]
-[bold blue]███████║██║╚██████╔╝██║ ╚═╝ ██║██║  ██║[/bold blue]
-[bold blue]╚══════╝╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝[/bold blue]
+[bold #3b82f6]███████╗██╗ ██████╗ ███╗   ███╗ █████╗ [/bold #3b82f6]
+[bold #60a5fa]██╔════╝██║██╔════╝ ████╗ ████║██╔══██╗[/bold #60a5fa]
+[bold #93c5fd]███████╗██║██║  ███╗██╔████╔██║███████║[/bold #93c5fd]
+[bold #60a5fa]╚════██║██║██║   ██║██║╚██╔╝██║██╔══██║[/bold #60a5fa]
+[bold #3b82f6]███████║██║╚██████╔╝██║ ╚═╝ ██║██║  ██║[/bold #3b82f6]
+[bold #1d4ed8]╚══════╝╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝[/bold #1d4ed8]
 
-[bold cyan]σ Finance Research Agent[/bold cyan] [dim]- Setup Wizard v3.3.1[/dim]
+[bold cyan]σ Finance Research Agent[/bold cyan] [dim]- Setup Wizard v3.4.0[/dim]
 """
 
 
@@ -265,7 +265,7 @@ class SetupWizard:
         if self.settings.default_provider != LLMProvider.OLLAMA:
             ollama_running, ollama_host = detect_ollama()
             if ollama_running and ollama_host:
-                console.print(f"[green]✓[/green] Ollama detected at {ollama_host}")
+                console.print(f"[green][ok][/green] Ollama detected at {ollama_host}")
                 if Confirm.ask("Enable Ollama as local fallback?", default=True):
                     save_setting("ollama_host", ollama_host)
                     console.print(f"[cyan]{SIGMA}[/cyan] Ollama enabled")
@@ -280,7 +280,7 @@ class SetupWizard:
         lean_installed, lean_cli, lean_dir = detect_lean_installation()
         
         if lean_installed:
-            console.print(f"[green]✓[/green] LEAN/QuantConnect detected!")
+            console.print(f"[green][ok][/green] LEAN/QuantConnect detected!")
             if lean_cli:
                 console.print(f"  [dim]CLI: {lean_cli}[/dim]")
             if lean_dir:
@@ -316,7 +316,7 @@ class SetupWizard:
                     success, message = install_lean_cli_sync()
                 
                 if success:
-                    console.print(f"[green]✓[/green] {message}")
+                    console.print(f"[green][ok][/green] {message}")
                     save_setting("lean_enabled", "true")
                     save_setting("lean_cli_path", "lean")
                     
@@ -325,7 +325,7 @@ class SetupWizard:
                     if lean_cli:
                         console.print(f"[cyan]{SIGMA}[/cyan] LEAN CLI ready: {lean_cli}")
                 else:
-                    console.print(f"[red]✗[/red] {message}")
+                    console.print(f"[red][x][/red] {message}")
                     console.print("[dim]You can install manually later: pip install lean[/dim]")
             
             elif lean_choice == "manual":
@@ -403,7 +403,7 @@ def quick_setup():
     choice = Prompt.ask("Provider", choices=["1", "2", "3"], default="1")
     
     providers = {
-        "1": ("google", "gemini-2.0-flash"),
+        "1": ("google", "gemini-3-flash-preview"),
         "2": ("groq", "llama-3.3-70b-versatile"),
         "3": ("ollama", "llama3.2"),
     }

sigma/tools.py

@@ -583,6 +583,211 @@ def get_market_news(tickers: str = "", topics: str = "") -> dict:
         return {"error": str(e)}
 
 
+# ============================================================================
+# POLYGON.IO TOOLS (Real-time & Historical Market Data)
+# ============================================================================
+
+def _get_polygon_key() -> Optional[str]:
+    """Get Polygon.io API key from config."""
+    try:
+        from .config import get_settings
+        return get_settings().polygon_api_key
+    except:
+        return None
+
+
+def polygon_get_quote(symbol: str) -> dict:
+    """Get real-time quote from Polygon.io with additional data."""
+    api_key = _get_polygon_key()
+    if not api_key:
+        return {"error": "Polygon API key not configured. Use /setkey polygon <key>", "fallback": True}
+    
+    import requests
+    
+    try:
+        symbol = symbol.upper()
+        
+        # Get previous day's data
+        prev_url = f"https://api.polygon.io/v2/aggs/ticker/{symbol}/prev?adjusted=true&apiKey={api_key}"
+        prev_response = requests.get(prev_url, timeout=10)
+        
+        if prev_response.status_code == 403:
+            return {"error": "Polygon API key is invalid or expired", "error_code": 1101}
+        elif prev_response.status_code == 429:
+            return {"error": "Polygon rate limit exceeded", "error_code": 1303}
+        elif prev_response.status_code != 200:
+            return {"error": f"Polygon API error: {prev_response.status_code}"}
+        
+        prev_data = prev_response.json()
+        
+        if prev_data.get("resultsCount", 0) == 0:
+            return {"error": f"No data found for {symbol}", "error_code": 1300}
+        
+        result = prev_data["results"][0]
+        
+        # Get ticker details
+        details_url = f"https://api.polygon.io/v3/reference/tickers/{symbol}?apiKey={api_key}"
+        details_response = requests.get(details_url, timeout=10)
+        details = {}
+        if details_response.status_code == 200:
+            details_data = details_response.json()
+            if details_data.get("results"):
+                details = details_data["results"]
+        
+        return {
+            "symbol": symbol,
+            "name": details.get("name", symbol),
+            "open": result.get("o", 0),
+            "high": result.get("h", 0),
+            "low": result.get("l", 0),
+            "close": result.get("c", 0),
+            "volume": result.get("v", 0),
+            "vwap": result.get("vw", 0),
+            "timestamp": result.get("t"),
+            "transactions": result.get("n", 0),
+            "market_cap": details.get("market_cap"),
+            "primary_exchange": details.get("primary_exchange"),
+            "type": details.get("type"),
+            "source": "polygon.io"
+        }
+    except requests.exceptions.Timeout:
+        return {"error": "Request timed out", "error_code": 1002}
+    except requests.exceptions.ConnectionError:
+        return {"error": "Connection error", "error_code": 1400}
+    except Exception as e:
+        return {"error": str(e), "error_code": 1000}
+
+
+def polygon_get_aggregates(symbol: str, timespan: str = "day", multiplier: int = 1, 
+                           from_date: str = "", to_date: str = "", limit: int = 120) -> dict:
+    """Get historical aggregated bars from Polygon.io."""
+    api_key = _get_polygon_key()
+    if not api_key:
+        return {"error": "Polygon API key not configured. Use /setkey polygon <key>"}
+    
+    import requests
+    
+    try:
+        symbol = symbol.upper()
+        
+        # Default date range: last 6 months
+        if not to_date:
+            to_date = datetime.now().strftime("%Y-%m-%d")
+        if not from_date:
+            from_date = (datetime.now() - timedelta(days=180)).strftime("%Y-%m-%d")
+        
+        url = (f"https://api.polygon.io/v2/aggs/ticker/{symbol}/range/"
+               f"{multiplier}/{timespan}/{from_date}/{to_date}"
+               f"?adjusted=true&sort=desc&limit={limit}&apiKey={api_key}")
+        
+        response = requests.get(url, timeout=15)
+        
+        if response.status_code != 200:
+            return {"error": f"Polygon API error: {response.status_code}"}
+        
+        data = response.json()
+        
+        if data.get("resultsCount", 0) == 0:
+            return {"error": f"No data found for {symbol}"}
+        
+        results = data["results"]
+        
+        # Calculate statistics
+        closes = [r["c"] for r in results]
+        highs = [r["h"] for r in results]
+        lows = [r["l"] for r in results]
+        volumes = [r["v"] for r in results]
+        
+        latest = results[0]
+        oldest = results[-1]
+        
+        return {
+            "symbol": symbol,
+            "timespan": timespan,
+            "from": from_date,
+            "to": to_date,
+            "data_points": len(results),
+            "latest_close": latest["c"],
+            "oldest_close": oldest["c"],
+            "period_return": round((latest["c"] / oldest["c"] - 1) * 100, 2),
+            "high": max(highs),
+            "low": min(lows),
+            "avg_volume": int(sum(volumes) / len(volumes)),
+            "total_volume": sum(volumes),
+            "source": "polygon.io"
+        }
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def polygon_get_ticker_news(symbol: str, limit: int = 10) -> dict:
+    """Get news articles for a ticker from Polygon.io."""
+    api_key = _get_polygon_key()
+    if not api_key:
+        return {"error": "Polygon API key not configured. Use /setkey polygon <key>"}
+    
+    import requests
+    
+    try:
+        symbol = symbol.upper()
+        url = f"https://api.polygon.io/v2/reference/news?ticker={symbol}&limit={limit}&apiKey={api_key}"
+        
+        response = requests.get(url, timeout=10)
+        
+        if response.status_code != 200:
+            return {"error": f"Polygon API error: {response.status_code}"}
+        
+        data = response.json()
+        articles = []
+        
+        for item in data.get("results", []):
+            articles.append({
+                "title": item.get("title", ""),
+                "author": item.get("author", ""),
+                "published": item.get("published_utc", ""),
+                "article_url": item.get("article_url", ""),
+                "tickers": item.get("tickers", []),
+                "description": item.get("description", "")[:300] + "..." if item.get("description") else "",
+                "keywords": item.get("keywords", [])[:5]
+            })
+        
+        return {
+            "symbol": symbol,
+            "articles": articles,
+            "source": "polygon.io"
+        }
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def polygon_market_status() -> dict:
+    """Get current market status from Polygon.io."""
+    api_key = _get_polygon_key()
+    if not api_key:
+        return {"error": "Polygon API key not configured. Use /setkey polygon <key>"}
+    
+    import requests
+    
+    try:
+        url = f"https://api.polygon.io/v1/marketstatus/now?apiKey={api_key}"
+        response = requests.get(url, timeout=10)
+        
+        if response.status_code != 200:
+            return {"error": f"Polygon API error: {response.status_code}"}
+        
+        data = response.json()
+        
+        return {
+            "market": data.get("market", "unknown"),
+            "server_time": data.get("serverTime"),
+            "exchanges": data.get("exchanges", {}),
+            "currencies": data.get("currencies", {}),
+            "source": "polygon.io"
+        }
+    except Exception as e:
+        return {"error": str(e)}
+
+
 # ============================================================================
 # EXA SEARCH TOOLS (Financial News, SEC Filings)
 # ============================================================================
@@ -1008,6 +1213,67 @@ TOOLS = [
             }
         }
     },
+    # Polygon.io tools (enhanced market data)
+    {
+        "type": "function",
+        "function": {
+            "name": "polygon_get_quote",
+            "description": "Get real-time stock quote with extended data from Polygon.io (requires API key)",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "symbol": {"type": "string", "description": "Stock ticker symbol (e.g., AAPL, MSFT)"}
+                },
+                "required": ["symbol"]
+            }
+        }
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "polygon_get_aggregates",
+            "description": "Get historical price aggregates/bars from Polygon.io with custom timespan",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "symbol": {"type": "string", "description": "Stock ticker symbol"},
+                    "timespan": {"type": "string", "enum": ["minute", "hour", "day", "week", "month"], "description": "Size of time window", "default": "day"},
+                    "multiplier": {"type": "integer", "description": "Size multiplier for timespan", "default": 1},
+                    "from_date": {"type": "string", "description": "Start date (YYYY-MM-DD)", "default": ""},
+                    "to_date": {"type": "string", "description": "End date (YYYY-MM-DD)", "default": ""},
+                    "limit": {"type": "integer", "description": "Number of results", "default": 120}
+                },
+                "required": ["symbol"]
+            }
+        }
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "polygon_get_ticker_news",
+            "description": "Get recent news articles for a stock from Polygon.io",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "symbol": {"type": "string", "description": "Stock ticker symbol"},
+                    "limit": {"type": "integer", "description": "Number of articles", "default": 10}
+                },
+                "required": ["symbol"]
+            }
+        }
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "polygon_market_status",
+            "description": "Get current market status (open/closed) from Polygon.io",
+            "parameters": {
+                "type": "object",
+                "properties": {},
+                "required": []
+            }
+        }
+    },
 ]
 
 
@@ -1032,12 +1298,20 @@ TOOL_FUNCTIONS = {
     "search_financial_news": search_financial_news,
     "search_sec_filings": search_sec_filings,
     "search_earnings_transcripts": search_earnings_transcripts,
+    # Polygon.io
+    "polygon_get_quote": polygon_get_quote,
+    "polygon_get_aggregates": polygon_get_aggregates,
+    "polygon_get_ticker_news": polygon_get_ticker_news,
+    "polygon_market_status": polygon_market_status,
 }
 
 
 def execute_tool(name: str, args: dict) -> Any:
-    """Execute a tool by name."""
+    """Execute a tool by name with error handling."""
     func = TOOL_FUNCTIONS.get(name)
     if func:
-        return func(**args)
-    return {"error": f"Unknown tool: {name}"}
+        try:
+            return func(**args)
+        except Exception as e:
+            return {"error": f"Tool execution failed: {str(e)}", "error_code": 1000}
+    return {"error": f"Unknown tool: {name}", "error_code": 1001}

sigma_terminal-3.4.0.dist-info/METADATA

@@ -0,0 +1,264 @@
+Metadata-Version: 2.4
+Name: sigma-terminal
+Version: 3.4.0
+Summary: Sigma - Finance Research Agent
+Project-URL: Homepage, https://github.com/desenyon/sigma
+Project-URL: Documentation, https://github.com/desenyon/sigma/wiki
+Project-URL: Repository, https://github.com/desenyon/sigma
+Author: Sigma Team
+License: Proprietary
+License-File: LICENSE
+Keywords: ai,analytics,backtesting,finance,investment,portfolio,quantitative,research,stocks,terminal,trading
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: anthropic>=0.18.0
+Requires-Dist: google-genai>=1.0.0
+Requires-Dist: groq>=0.4.0
+Requires-Dist: httpx>=0.26.0
+Requires-Dist: kaleido>=0.2.1
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: openai>=1.12.0
+Requires-Dist: pandas>=2.2.0
+Requires-Dist: pillow>=10.2.0
+Requires-Dist: plotext>=5.2.8
+Requires-Dist: plotly>=5.18.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: pyobjc-framework-cocoa>=10.0; sys_platform == 'darwin'
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: scipy>=1.12.0
+Requires-Dist: textual>=0.47.0
+Requires-Dist: yfinance>=0.2.36
+Provides-Extra: all
+Requires-Dist: black>=24.0.0; extra == 'all'
+Requires-Dist: lean>=1.0.0; extra == 'all'
+Requires-Dist: mypy>=1.8.0; extra == 'all'
+Requires-Dist: py2app>=0.28.0; extra == 'all'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'all'
+Requires-Dist: pytest>=8.0.0; extra == 'all'
+Requires-Dist: ruff>=0.2.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: black>=24.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: py2app>=0.28.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.2.0; extra == 'dev'
+Provides-Extra: lean
+Requires-Dist: lean>=1.0.0; extra == 'lean'
+Description-Content-Type: text/markdown
+
+<h1 align="center">
+  <code>σ</code> SIGMA
+</h1>
+
+<p align="center">
+  <strong>The AI-Powered Finance Research Agent</strong>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#features">Features</a> •
+  <a href="#commands">Commands</a> •
+  <a href="#architecture">Architecture</a> •
+  <a href="#roadmap">Roadmap</a>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-3.4.0-blue.svg" alt="Version 3.4.0"/>
+  <img src="https://img.shields.io/badge/python-3.11+-green.svg" alt="Python 3.11+"/>
+  <img src="https://img.shields.io/badge/platform-cross--platform-lightgrey.svg" alt="Cross Platform"/>
+  <img src="https://img.shields.io/badge/AI-Multi--Provider-purple.svg" alt="Multi-Provider AI"/>
+  <img src="https://img.shields.io/badge/license-Proprietary-red.svg" alt="License"/>
+</p>
+
+---
+
+## What is Sigma?
+
+**Sigma isn't just another finance app.** It's a conversational AI agent that thinks like a quant, analyzes like a hedge fund, and speaks like your smartest friend who happens to be a CFA.
+
+## Quick Start
+
+### One Command Install
+
+\`\`\`bash
+pip install sigma-terminal
+\`\`\`
+
+### Launch Sigma
+
+\`\`\`bash
+sigma
+\`\`\`
+
+Or alternatively: `python -m sigma`
+
+### First Launch = Automatic Setup
+
+**That's it.** Sigma detects it's your first time and walks you through:
+
+1. **Choose AI Provider** — Google Gemini, OpenAI, Anthropic, Groq, xAI, or Ollama
+2. **Enter API Key** — Or use local Ollama (completely free, no key needed!)
+3. **Auto-detect Integrations** — Finds Ollama, LEAN, and more
+4. **Launch Directly** — Straight into the beautiful terminal UI
+
+Your config persists at \`~/.sigma/\` — **setup never asks again**.
+
+---
+
+## Features
+
+### Multi-Provider AI Engine
+
+Switch between providers on the fly. Use free tiers or bring your own keys.
+
+| Provider                | Models                       | Speed     | Cost           | Tool Calls |
+| ----------------------- | ---------------------------- | --------- | -------------- | ---------- |
+| **Google Gemini** | gemini-2.5-flash, 2.5-pro    | Fast      | Free tier      | Native     |
+| **OpenAI**        | gpt-4o, gpt-4o-mini, o3-mini | Fast      | Paid           | Native     |
+| **Anthropic**     | claude-sonnet-4, 3.5-sonnet  | Fast      | Paid           | Native     |
+| **Groq**          | llama-3.3-70b                | Very Fast | Free tier      | Native     |
+| **xAI**           | grok-2, grok-2-mini          | Fast      | Paid           | Native     |
+| **Ollama**        | llama3.2, mistral, phi3      | Local     | **FREE** | Native     |
+
+**Built-in Rate Limiting** — No more API flooding or timeouts.
+
+**Error Codes** — Clear error codes (E1100-E1400) help you quickly diagnose issues.
+
+### Real-Time Market Intelligence
+
+| Tool                            | What It Does                                  |
+| ------------------------------- | --------------------------------------------- |
+| \`get_stock_quote\`             | Live price, change, volume, market cap        |
+| \`technical_analysis\`          | RSI, MACD, Bollinger, MAs, Support/Resistance |
+| \`get_financial_statements\`    | Income, balance sheet, cash flow              |
+| \`get_analyst_recommendations\` | Price targets, ratings, consensus             |
+| \`get_insider_trades\`          | Who's buying, who's selling                   |
+| \`get_institutional_holders\`   | Track the smart money                         |
+| \`compare_stocks\`              | Multi-stock comparison with metrics           |
+| \`get_market_overview\`         | Major indices at a glance                     |
+| \`get_sector_performance\`      | Sector rotation analysis                      |
+
+### Data APIs
+
+| Tool                        | Source        | What It Does                         |
+| --------------------------- | ------------- | ------------------------------------ |
+| \`get_economic_indicators\` | Alpha Vantage | GDP, inflation, unemployment, CPI    |
+| \`get_intraday_data\`       | Alpha Vantage | 1min to 60min candles                |
+| \`get_market_news\`         | Alpha Vantage | News with sentiment analysis         |
+| \`polygon_get_quote\`       | Polygon.io    | Real-time quotes with extended data  |
+| \`polygon_get_aggregates\`  | Polygon.io    | Historical bars with custom timespan |
+| \`polygon_get_ticker_news\` | Polygon.io    | News articles for specific tickers   |
+| \`search_financial_news\`   | Exa           | Search Bloomberg, Reuters, WSJ       |
+| \`search_sec_filings\`      | Exa           | 10-K, 10-Q, 8-K filings              |
+
+### Backtesting Engine
+
+| Strategy          | Description             | Use Case           |
+| ----------------- | ----------------------- | ------------------ |
+| \`sma_crossover\` | 20/50 MA crossover      | Trend following    |
+| \`rsi\`           | RSI oversold/overbought | Mean reversion     |
+| \`macd\`          | MACD signal crossovers  | Momentum           |
+| \`bollinger\`     | Band breakout/bounce    | Volatility         |
+| \`momentum\`      | Price momentum          | Trend continuation |
+| \`breakout\`      | S/R level breaks        | Breakout trading   |
+
+---
+
+## Commands
+
+### In-App Commands
+
+| Command                     | Description                      |
+| --------------------------- | -------------------------------- |
+| \`/help\`                   | Comprehensive help with examples |
+| \`/clear\`                  | Clear chat history               |
+| \`/keys\`                   | Configure API keys (improved!)   |
+| \`/models\`                 | Show available models            |
+| \`/status\`                 | Current configuration            |
+| \`/provider `<name>`\`    | Switch AI provider               |
+| \`/model `<name>`\`       | Switch model                     |
+| \`/setkey `<p>` `<k>`\` | Set API key for provider         |
+| \`/backtest\`               | Show backtesting strategies      |
+
+### Keyboard Shortcuts
+
+| Shortcut   | Action                  |
+| ---------- | ----------------------- |
+| \`Tab\`    | Autocomplete suggestion |
+| \`Ctrl+L\` | Clear chat              |
+| \`Ctrl+M\` | Show models             |
+| \`Ctrl+H\` | Toggle quick help       |
+| \`Esc\`    | Cancel operation        |
+
+---
+
+## Configuration
+
+### Config Location
+
+\`\`\`
+~/.sigma/
+|-- config.env           # API keys and settings
+└── .first_run_complete  # First-run marker
+\`\`\`
+
+### Error Codes
+
+| Code Range | Category | Example                 |
+| ---------- | -------- | ----------------------- |
+| E1000-1099 | General  | E1002: Timeout          |
+| E1100-1199 | API Keys | E1101: Invalid API key  |
+| E1200-1299 | Provider | E1202: Model not found  |
+| E1300-1399 | Data     | E1300: Symbol not found |
+| E1400-1499 | Network  | E1400: Connection error |
+
+---
+
+## Changelog
+
+### v3.4.0 (Current)
+
+- [X] **Improved API Key Management** — Beautiful \`/keys\` interface with URLs
+- [X] **Polygon.io Integration** — Real-time quotes, aggregates, news
+- [X] **xAI Grok Support** — Full support for Grok-2 and Grok-2-mini
+- [X] **Error Codes** — Structured error codes (E1000-E1499)
+- [X] **Updated Models** — Removed deprecated, added latest versions
+- [X] **Enhanced AI** — Maximum helpfulness with proactive insights
+- [X] **Modern UI** — Gradient blues, improved styling
+- [X] **Cross-Platform** — Works on macOS, Linux, Windows
+
+### v3.3.x
+
+- [X] Auto-setup on first launch
+- [X] LEAN auto-detection
+- [X] API rate limiting
+- [X] Ollama native tool calls
+- [X] Alpha Vantage & Exa integration
+
+---
+
+## Acknowledgments
+
+Built with [Textual](https://textual.textualize.io/), [Rich](https://rich.readthedocs.io/), [yfinance](https://github.com/ranaroussi/yfinance), [Plotly](https://plotly.com/python/), LEAN
+
+AI: [Google Gemini](https://ai.google.dev/) • [OpenAI](https://openai.com/) • [Anthropic](https://anthropic.com/) • [Groq](https://groq.com/) • [xAI](https://x.ai/) • [Ollama](https://ollama.ai/)
+
+Data: [Polygon.io](https://polygon.io/) • [Alpha Vantage](https://www.alphavantage.co/) • [Exa](https://exa.ai/)
+
+---
+
+<p align="center">
+  <code>σ</code> — Finance Research AI Agent
+</p>