Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

jackson-cmd/zeus-options-terminal

Finance

A self-hosted options trading terminal for tracking positions, Greeks, risk, news, and trade journaling with broker or CSV data.

104
18
Python
NOASSERTION
4 days old

What it is

ZEUS Terminal is a local web application for retail options traders who want live positions, P/L, Greeks, risk metrics, exit discipline, paper trading, a screener, news, SEC filings, and a trade journal on one screen. It connects read-only to tastytrade, Alpaca, or Public, or works from a CSV of fills, and it runs on your own machine in Chinese, bilingual, or English.

Quick start

The fastest route without cloning anything is pipx (Python 3.10+):

pipx install zeus-options-terminal
zeus

The browser opens at http://localhost:8765. On the Positions page, press Load the sample to populate every page with a demo portfolio priced from current quotes. To use real data, open ⚙ Settings → Broker & data, enter broker credentials (each block has a Test connection button), or upload a CSV of trades. News, AI, and e-mail alerts are optional on the same page. A clone-based ./start.sh/start.bat path and a Docker image are also documented in the quick start.

Brokers and data sources

Positions and quotes are chosen separately, so you can keep uploaded trades while pulling quotes from a broker. tastytrade provides streaming DXLink quotes and the smoothest P/L; Alpaca has a free account with paper trading and IEX stock data; Public covers its own customers. Without a broker, options quotes come from Cboe's delayed feed and stocks from Yahoo Finance with Finviz fallback. Benzinga Pro is optional; the free digest uses Finviz, WSJ, and MarketWatch. The credentials required per source are listed in the settings table (see what each setting unlocks).

What stays local and what leaves

Settings, tokens, cookies, and trades live in ~/.zeus-terminal/ (mode 600), and runtime data goes to ~/.zeus-terminal/runtime/. The server binds to 127.0.0.1 by default and rejects foreign Host headers. There is no telemetry; the app talks only to connected services and public market data. Agents connecting over the local MCP endpoint can read positions and run checkups, and can paper trade only if enabled; no MCP tool can place a real order or read a saved key. Content sent to an AI provider goes to that provider.

Constraints

  • Platform: Python 3.10+ for pipx or clone installs; Docker images cover amd64 and arm64. Desktop notifications are macOS only; on Linux use e-mail alerts.
  • Order placement: the terminal never places real orders; paper trades are simulated locally.
  • Market data: free quotes are delayed (~15 minutes) and rate-limited, so some fields fall back between sources; options sentiment percentiles need weeks of accumulated daily chain data.
  • License: PolyForm Noncommercial 1.0.0 — personal, research, and hobby use allowed; commercial use prohibited. It is not investment advice.

HotRepo's take

On 2026-11-16 the project appeared on the HotRepo new-projects list for Python with 104 stars, 18 forks, and a 4-star gain over the recorded one-hour window; it has no recorded GitHub all-language daily ranking. With only that single short-window snapshot there is no basis here to judge a trend. The substantive signal is the delivery surface: pipx, Docker, and an MCP server endpoint alongside a non-commercial license, which positions it as a personal self-hosted tool rather than a hosted service.

HotRepo 点评

2026-11-16 该项目进入 HotRepo 的 Python 新项目榜,记录到 104 star、18 fork,在一小时窗口内净增 4 star;没有 GitHub 全语言日榜名次记录。仅凭这一次短窗口快照,无法据此判断热度走势。更实质的信号是交付方式:pipx、Docker 和本地 MCP 端点配合非商业许可证,说明它面向个人自托管,而不是托管服务。

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. jackson-cmd/risk-aware-trading-agentsAn open-source framework for US stock trading agents with look-ahead-safe news backtesting, macro regime detection and paper trading.Python107
  2. tradermonty/claude-trading-skillsClaude Skills toolkit that structures market review, trade planning, risk checks, and journaling for time-constrained retail investors.Python3,842
  3. HKUDS/Vibe-TradingA Python agent for market research, backtesting, paper trading and opt-in broker execution.Python38,281
  4. nautechsystems/nautilus_traderAn event-driven Rust trading engine that runs the same Python strategy code in backtest and live execution.Rust30,869
  5. TauricResearch/TradingAgentsA multi-agent LLM framework that debates and decides stock trades, for researchers and quant-curious developers.Python113,662