Skip to content

mphinance/tightspread

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🩲 TightSpread

TraderDaddy's better half. Trading desktop app — Reflex UI, MCP agents, FastAPI backend.

"Daddy likes a tight spread." — The Community, apparently


What Is This?

The daily-driver trading dashboard for mphinance. Real-time portfolio monitoring, AI copilot, scanner widgets, and brokerage integration — all in one Docker Compose stack.

Lives as a submodule of the mphinance monorepo so the dossier pipeline can share data with the trading UI while each piece versions independently.

Stack

Component Tech Description
alpha-reflex/ Reflex (Python) Trading dashboard UI (Tauri candidate)
frontend/ HTML/JS Static widget dashboard
api/ FastAPI Backend serving scanner results, copilot, portfolio
agents/ Python/TS MCP servers Brokerage integrations (Tradier, TastyTrade)
services/ Python Shared service layer (charting, news, brokerages)

Quick Start

# Clone with parent repo
git clone --recurse-submodules https://github.com/mphinance/mphinance.git

# Or standalone
git clone https://github.com/mphinance/tightspread.git
cp .env.example .env
# Fill in your API keys

# Run the stack
docker-compose up -d

Architecture

tightspread/
├── alpha-reflex/         # Reflex trading UI
│   ├── alpha_reflex/     # Components, state, theme
│   ├── services/         # Tradier, TastyTrade, charting, news
│   └── core/             # Data engine, signals
├── frontend/             # Static HTML dashboard
│   ├── index.html
│   └── js/widgets/       # 13 widget modules
├── api/                  # FastAPI backend
├── agents/               # MCP server services
│   ├── tasty-agent/      # TastyTrade MCP
│   ├── tradier-agent/    # Tradier MCP
│   └── trading-mcp/      # General trading MCP (TS)
├── services/             # Shared service layer
├── core/                 # Data engine + signals
├── scanners/             # Scanner data + engine
├── docker-compose.yml    # Full stack orchestration
└── Dockerfile.*          # Per-service Dockerfiles

Related


Not financial advice. Trade at your own risk. Past performance does not guarantee future results.

About

TraderDaddy's better half. Trading desktop app — Reflex UI, MCP agents, FastAPI backend.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors