Sigma - Finance Research Agent
Project description
σ SIGMA
The Terminal-Based Financial Research Agent
What is Sigma?
Sigma is a financial analysis terminal powered by modern AI. It unifies natural language research, quantitative backtesting, and real-time market data into a single, high-performance CLI application.
Unlike generic chat tools, Sigma is built for finance:
- Deterministic Tools: Real APIs for quotes, financials, and news—no hallucinations.
- Local & Cloud AI: Route queries to OpenAI, Anthropic, Gemini, or run locally with Ollama.
- Integrated Backtesting: First-class support for LEAN engine to test strategies instantly.
- Privacy First: Your API keys and strategies stay on your machine.
Installation
Prerequisites
- Python 3.11+
- [Optional] Docker (for LEAN) or LEAN CLI
- [Optional] Ollama (for local inference)
One-Command Setup
Sigma includes an intelligent Setup Agent that handles the heavy lifting.
# Clone and install
pip install sigma-terminal
# Launch (triggers Setup Agent on first run)
python -m sigma
The Setup Agent will:
- Detect your OS and Python environment.
- Install the LEAN backtesting engine (if missing).
- Install and configure Ollama (if missing).
- help you add API keys for data providers (Polygon, Alpha Vantage, etc.).
Usage
Sigma is designed for natural language. Just type what you need.
Market Research
"Analyze AAPL and compare it with MSFT for the last 5 years" "Get me the latest earnings report for NVDA and summarize risks" "Show me a chart of SPY vs QQQ YTD"
Quantitative Backtesting
"Backtest a simple moving average crossover on BTC-USD from 2020" "Run a momentum strategy on TSLA, weekly rebalance"
Tool & System Control
"Switch model to local llama3" "List all available tools" "/backtest AAPL -s sma_cross" (Shortcuts available)
Architecture
Sigma v3.5.0 is built on a modular, event-driven architecture:
| Component | Description |
|---|---|
| Core Engine | Orchestrates intent parsing, tool routing, and result synthesis. |
| LLM Router | Intelligent routing between OpenAI, Anthropic, Google, and Ollama. Handles rate limits and fallbacks. |
| Tool Registry | A typed system connecting the LLM to 30+ financial data functions. |
| Backtest Service | Wraps the LEAN engine to stream logs and results directly to the TUI. |
| UI (Textual) | A multi-pane terminal interface with real-time streaming, trace logs, and plotting. |
Configuration
Configuration is stored in ~/.sigma/ and managed automatically. You can also edit it manually:
~/.sigma/config.json:
{
"default_model": "gpt-4o",
"ollama_url": "http://localhost:11434",
"data_providers": {
"polygon": "ENABLED",
"yfinance": "FALLBACK"
}
}
Supported Providers
- AI: OpenAI, Anthropic (Claude), Google (Gemini), Ollama (Local)
- Data: Polygon.io, Alpha Vantage, Financial Modeling Prep, YFinance (Default)
License
Proprietary / Closed Source. Copyright (c) 2026 Sigma Team. All Rights Reserved.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sigma_terminal-3.5.0.tar.gz.
File metadata
- Download URL: sigma_terminal-3.5.0.tar.gz
- Upload date:
- Size: 139.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a5d2066dadd7c73e5f5fe6093b368a555a4ea0aa342a4a9653baec0cb9ab57be
|
|
| MD5 |
ef73e8386c5426bbd4d0a6fc27a4d5a6
|
|
| BLAKE2b-256 |
a0b6a1096b6780eb3640f592fd8d9fb8d4f288bc319889dae7591c775a4c96dd
|
Provenance
The following attestation bundles were made for sigma_terminal-3.5.0.tar.gz:
Publisher:
release.yml on desenyon/sigma
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sigma_terminal-3.5.0.tar.gz -
Subject digest:
a5d2066dadd7c73e5f5fe6093b368a555a4ea0aa342a4a9653baec0cb9ab57be - Sigstore transparency entry: 909479864
- Sigstore integration time:
-
Permalink:
desenyon/sigma@c15db90df412ab614a5336116e036090dca2e8a2 -
Branch / Tag:
refs/tags/v3.5.0 - Owner: https://github.com/desenyon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@c15db90df412ab614a5336116e036090dca2e8a2 -
Trigger Event:
push
-
Statement type:
File details
Details for the file sigma_terminal-3.5.0-py3-none-any.whl.
File metadata
- Download URL: sigma_terminal-3.5.0-py3-none-any.whl
- Upload date:
- Size: 146.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
80b6c3b333a78a74f3979a49be7fdd72d5d70219f754ffa636cb58c6e0e39ffa
|
|
| MD5 |
ddd2057f08d95891280074eefe9f87da
|
|
| BLAKE2b-256 |
0037a7c6e30083785edb068f4cc5c8054a761642d813c9c2d3f88b475a230d66
|
Provenance
The following attestation bundles were made for sigma_terminal-3.5.0-py3-none-any.whl:
Publisher:
release.yml on desenyon/sigma
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sigma_terminal-3.5.0-py3-none-any.whl -
Subject digest:
80b6c3b333a78a74f3979a49be7fdd72d5d70219f754ffa636cb58c6e0e39ffa - Sigstore transparency entry: 909479898
- Sigstore integration time:
-
Permalink:
desenyon/sigma@c15db90df412ab614a5336116e036090dca2e8a2 -
Branch / Tag:
refs/tags/v3.5.0 - Owner: https://github.com/desenyon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@c15db90df412ab614a5336116e036090dca2e8a2 -
Trigger Event:
push
-
Statement type: