68 dead investors watch your every trade. One of them hates you personally.
Warren Buffett judges your entries. Jesse Livermore roasts your stops. SBF's ghost haunts your leverage.
Vibe Sensei is a terminal-native AI trading copilot where historical legends — Buffett, Soros, Livermore, Graham, Simons, Sun Tzu, and 62 more — watch your trades from the shadows. Each user gets a deterministic guardian master who warns in character, debates other masters before big moves, and evolves alongside your habits.
Paper trading sandbox included. 100K USDT starting balance. No real money at risk unless you choose it.
"Isn't this just ai-hedge-fund?"
No. They write reports. Our 68 masters yell at you in character, then SBF's ghost shows up when you touch leverage. Plus master debates, rarity tiers, ghost warnings, braille charts, and a full terminal-native experience that doesn't need a browser.
git clone https://github.com/VictorVVedtion/vibe-sensei
cd vibe-sensei
bun install
bun run devThen /login and pick Google --- Gemini's free tier works with just a Google account. No API key, no credit card. You're talking to Buffett's ghost in 60 seconds.
Got a Claude or ChatGPT Plus account? Same /login flow, pick that provider instead. Got an API key? export ANTHROPIC_API_KEY=... (or OPENAI_API_KEY, GEMINI_API_KEY) and skip /login.
Requirements: Bun >= 1.3.
All providers --- exact auth, default models, routing notes
| Provider | How to authenticate | Default model | Routing |
|---|---|---|---|
| Google Gemini (free tier) | /login (Google account) |
gemini-3-flash-preview |
cloudcode-pa.googleapis.com --- reuses the Gemini CLI free-tier OAuth. No API key needed. Pro models (gemini-3.1-pro-preview, gemini-3-pro-preview) auto-remap to gemini-2.5-pro on this tier. |
| OpenAI Codex | /login (ChatGPT Plus/Pro) |
gpt-5.4 |
chatgpt.com/backend-api/codex/responses --- reuses your ChatGPT subscription, no separate API key. Maps /effort to reasoning.effort: low|medium|high. |
| Anthropic | ANTHROPIC_API_KEY env, or /login |
claude-opus-4-6 |
First-party API, plus Bedrock (CLAUDE_CODE_USE_BEDROCK=1) and Vertex (CLAUDE_CODE_USE_VERTEX=1). |
| Google Gemini (paid API) | GEMINI_API_KEY env |
gemini-3-flash-preview |
generativelanguage.googleapis.com --- higher quota than the free tier, supports the full 3.x lineup. |
| OpenAI API | OPENAI_API_KEY env |
gpt-5.4 |
Standard Responses API. |
| Others | provider env var | varies | DeepSeek, Groq, xAI, Mistral via the OpenAI-compat layer. |
/login is a 3-way picker. /model lists every model your credentials unlock --- 13 extra non-Anthropic models surface when the matching creds are present. /provider shows status, sets the active model, and reports session cost. Switch providers mid-session without restarting.
- You type
/buy BTC 50000 - Pre-Trade Gate runs 9 risk checks + circuit breaker
- Your guardian master warns you in character ("Be fearful when others are greedy...")
- If you're overleveraged, SBF's ghost appears ("I too thought leverage was just a number")
- Two masters debate your trade (Soros FOR, Graham AGAINST)
- You confirm or back off
- Your guardian's diary tracks the outcome and learns your patterns
68 Master Guardians -- 5 rarity tiers, 9 archetypes, 5 stat dimensions
Each master is a real historical figure with a known trading philosophy. Your guardian is assigned deterministically from your user ID via seeded PRNG (mulberry32(hash(userId))).
5 Rarity Tiers -- 9 Archetypes (value investor, trend follower, macro trader, quant, strategist, philosopher, first principles, crypto native, scientist) -- 5 Stats (Precision, Patience, Aggression, Wisdom, Sass)
| Tier | Masters |
|---|---|
| Legendary (8) | Jesse Livermore, George Soros, Warren Buffett, Benjamin Graham, Jim Simons, Sun Tzu, Satoshi Nakamoto, John von Neumann |
| Epic (18) | Paul Tudor Jones, Stanley Druckenmiller, Michael Burry, Charlie Munger, Ray Dalio, Ed Thorp, Munehisa Homma, Miyamoto Musashi, Nassim Taleb, Elon Musk, Peter Thiel, Garry Tan, Andrej Karpathy, Li Ka-shing, Vitalik Buterin, Alan Turing, Benoit Mandelbrot, Claude Shannon |
| Rare + Uncommon + Common (42) | 42 more across all archetypes |
10 Ghost Warnings -- cautionary apparitions from finance's fallen
They appear when you repeat their mistakes.
| Ghost | Trigger |
|---|---|
| Sam Bankman-Fried | Missing risk controls |
| Do Kwon | Ignoring alerts (arrogance) |
| Su Zhu / 3AC | Leverage >3x |
| Isaac Newton | FOMO buying after >20% pump |
| LTCM | Correlation collapse |
| Lehman Brothers | Cascade liquidation risk |
| Enron | Concentrated loser (>60% portfolio) |
| SVB | Duration mismatch (underwater hold) |
| BitMEX Rekt Trader | Overleveraged margin |
| Bill Hwang / Archegos | Concentrated leverage stack |
Risk Engine -- 9 checks + circuit breaker + tilt detector
Pre-Trade Gate -- 9 checks + circuit breaker + ATR stop-loss advisor:
Circuit Breaker, Portfolio Heat, Single Position Risk, Concentration, Regime Alignment, Volume Confirmation, Stop-Loss Defined, Risk-Reward Ratio, Revenge Trade Detection
Tilt Detector -- 3+ consecutive losses or size escalation >150% triggers an emotional trading alert.
Knowledge Base -- persistent, compounding trading wiki
A persistent, compounding trading knowledge base at ~/.vibe-sensei/. Three layers:
- Event Store -- JSONL persistence, 8 event types, append-only
- Wiki -- LLM-compiled markdown articles (per-symbol stats, behavioral patterns, trader profile)
- WikiTool -- 6 operations: compile, query, ingest, lint, browse, status
Includes morning brief, counterfactual tracking, anti-portfolio, milestones, and health auditor.
Sentiment Layer -- 30-day cross-source sentiment brief
/pulse delivers a 30-day cross-source sentiment brief from Reddit, Hacker News, Polymarket, and YouTube. Synthesized in your guardian's voice. Auto-injected into pre-trade debate stances.
Backtest Engine -- replay legendary strategies with braille equity curves
/backtest lets you replay strategies from legendary traders. Braille-rendered equity curves render directly in the terminal. Compare your approach against the masters.
| Command | What it does |
|---|---|
/buy <sym> [qty] |
Pre-trade gate, confirm, order |
/sell <sym> [qty] |
Gate, close position |
/swap <from> <to> <amt> |
DEX swap with slippage warning |
/positions |
Open positions with P&L |
/balance |
Portfolio breakdown |
/risk <sym> <side> <qty> |
Dry-run risk check (no order) |
/chart <sym> [tf] |
Interactive candlestick chart |
/consult <master> <q> |
Ask any of the 68 masters |
/debate <topic> |
Two masters argue, then synthesis |
/pulse <sym> |
30-day sentiment brief |
/master |
Guardian card + diary panel |
/summon |
Replay summoning ceremony |
/backtest <strategy> |
Backtest a legendary strategy |
/login |
3-way provider picker (Anthropic / OpenAI / Gemini) with PKCE OAuth |
/model |
Pick a model; surfaces Claude + 13 extra (6 Gemini, 7 GPT-5 family) when creds present |
/provider |
Show provider status, list models, set active model, view session cost |
Architecture
| Layer | Technology |
|---|---|
| Runtime | Bun |
| CLI UI | React + Ink |
| Desktop | Electron + xterm.js + TradingView |
| TUI | Rust + ratatui + braille charts |
| Market Data | Hyperliquid REST API |
| Exchange | CCXT (paper mode default) |
| Knowledge | JSONL + LLM wiki compiler |
| Build | Bun bundler (~28MB single-file) |
src/
buddy/ -- Guardian system (68 masters, debates, ghosts, diary)
commands/ -- Slash command implementations (/login, /model, /buy, ...)
tools/ -- 13 trading tools
services/
api/providers/ -- Multi-provider layer (Anthropic / OpenAI Codex / Gemini)
stream-event-helpers, schema sanitizer, thought-signature
exchange/ -- Paper + live trading via CCXT
knowledge/ -- Event store + wiki compiler
trading/ -- Guardian observer + tilt detector
components/ -- React/Ink terminal UI
screens/REPL.tsx -- Main interactive loop
See CONTRIBUTING.md. The highest-impact first contribution: add a new master guardian or draw sprites for one of the 14 masters still missing PNG art.
See ROADMAP.md for shipped versions and what's next.
See SECURITY.md. Paper mode by default. Fail-closed PreTradeGate on all order tools.