[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-2957":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":13,"stars7d":15,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":12,"compositeScore":17,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":8,"pushedAt":8,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":14,"starSnapshotCount":14,"syncStatus":13,"lastSyncTime":25,"discoverSource":26},2957,"BB-Terminal","vaughanf1\u002FBB-Terminal","vaughanf1",null,"TypeScript",198,90,6,2,0,7,41,51.48,false,"main",true,[],"2026-06-12 04:00:16","# BBterminal\n\nA Bloomberg-style intelligence dashboard for free financial data.\n\nRuns locally. One data layer (OpenBB Platform — 50+ providers, 270 endpoints), one amber-on-black terminal UI, and a built-in rules engine that turns numbers into **signals** so you don't stare at raw data trying to remember what matters.\n\nBuilt on [OpenBB](https:\u002F\u002Fgithub.com\u002FOpenBB-finance\u002FOpenBB) + Vite + React + TypeScript + TradingView lightweight-charts.\n\n![screenshot — Command Center landing page](app\u002Fv2-help.png)\n\n---\n\n## Install in one line\n\nPaste this into your terminal (macOS or Linux):\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fvaughanf1\u002FBB-Terminal\u002Fmain\u002Finstall.sh | bash\n```\n\nThat's it. The installer will:\n\n1. Check that `git`, Python 3.10+, and Node.js 18+ are on your system (and tell you exactly how to install them if not)\n2. Clone this repo to `~\u002FBB-Terminal`\n3. Install OpenBB Platform and all its data providers (~3 min)\n4. Install the UI dependencies (~1 min)\n5. Launch both servers and open the terminal in your browser\n\n**Windows users:** run the command inside **WSL** (Ubuntu) or **Git Bash**.\n\n### Every launch after that\n\n```bash\ncd ~\u002FBB-Terminal\n.\u002Fstart.sh     # launches API + UI, opens your browser\n.\u002Fstop.sh      # when you're done\n```\n\nThe UI lives at **http:\u002F\u002Flocalhost:5173\u002F**. All data works out of the box via **Yahoo Finance** — no API keys required. Optional providers (FRED, TradingEconomics, FMP, Polygon, etc.) can be added to `~\u002F.openbb_platform\u002Fuser_settings.json`.\n\n### Prerequisites\n\n- macOS or Linux (Windows via WSL)\n- Python 3.10, 3.11, or 3.12\n- Node.js 18+\n- ~2 GB free disk (OpenBB pulls many provider libraries)\n\n### Manual install (for anyone who doesn't trust `curl | bash`)\n\nFair enough — that pattern is a real risk if you don't know what's in the script. You can read [`install.sh`](.\u002Finstall.sh) first, or skip it entirely and run the steps yourself:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fvaughanf1\u002FBB-Terminal.git\ncd BB-Terminal\n.\u002Fsetup.sh       # installs OpenBB + UI (~3-5 min)\n.\u002Fstart.sh       # launches the terminal\n```\n\n---\n\n## What it does\n\n### Command Center (`CC`) — the landing page\nOne screen, 30-second briefing: US indices with sparklines, yield-curve shape (flat \u002F normal \u002F inverted), FX majors, BTC\u002FETH, top 5 gainers + losers (click to drill in), headline news.\n\n### INTEL (`\u003CTICKER>` or `AAPL INTEL`) — the scorecard\nSynthesizes the noisy stuff into an interpretable opinion:\n\n```\nINTELLIGENCE VERDICT   BULLISH\n● 8 bullish   ● 2 neutral   ● 1 bearish\n\nTECHNICAL              VALUATION              FUNDAMENTALS\n● Above 50d MA +5.1%   ● Fair P\u002FE 22.4x       ● Revenue growing +12%\n● Above 200d MA +8.2%  ● Rich EV\u002FEBITDA 25x   ● Operating margin strong\n● Upper range 73% of   ● Fwd P\u002FE improving    ● Low leverage\n\nANALYSTS               DIVIDEND\n● Buy consensus        ● Healthy payout\n● Bullish target +14%\n```\n\nEach dot is a *rule*, not a prediction — see `app\u002Fsrc\u002Flib\u002Fsignals.ts` for the thresholds. It's meant to save the 15 minutes of reading, not replace judgement.\n\n### The function codes\nType any of these in the command bar:\n\n| Code    | What it shows                              |\n|---------|--------------------------------------------|\n| `CC`    | Command Center dashboard (home)            |\n| `HELP`  | Full function directory                    |\n| `\u003CTICKER>` | Opens INTEL scorecard                   |\n| `DES`   | Company description \u002F profile              |\n| `GP`    | Candlestick chart, 1M–5Y                   |\n| `QR`    | Live quote (refreshes every 3s)            |\n| `HP`    | Historical prices table                    |\n| `FA`    | 5-year income statements                   |\n| `KEY`   | All ratios (valuation, growth, margins…)   |\n| `DVD`   | Dividend history + annual totals           |\n| `EE`    | Analyst targets + recommendation           |\n| `NI`    | Company news (50 headlines)                |\n| `OMON`  | Full options chain — calls \u002F strike \u002F puts |\n| `WEI`   | World equity indices                       |\n| `MOV`   | Market movers (gainers \u002F losers \u002F active)  |\n| `CRYPTO`| Top-12 crypto prices + sparklines          |\n| `FXC`   | Major FX pairs                             |\n| `CURV`  | US Treasury yield curve + spreads          |\n\nSyntax: `[SYMBOL] CODE` — e.g., `TSLA KEY`, or `WEI` (no symbol), or just `NVDA` (defaults to INTEL).\n\nKeyboard: `↑\u002F↓` walks history, `⇥` autocompletes codes, `\u002F` focuses the command bar, `\u003CGO>` or `Enter` executes.\n\n---\n\n## YouTube demo script\n\nTight 5-7 minute walk-through for the video:\n\n1. **Open on a black screen** — `.\u002Fstart.sh`, browser pops up to Command Center. Say: *\"Here's a Bloomberg-style terminal I built in an afternoon, running entirely on my laptop, using free data.\"*\n2. **CC dashboard tour (45s)** — \"S&P's down 0.4%, VIX is up 2%, yield curve is normal at +52bps, biggest gainer today is URI up 23%.\"\n3. **Click a gainer** — it opens INTEL. *\"Now the terminal tells me what it thinks: 5 bullish, 2 bearish signals. This stock is trading at the upper range, P\u002FE is rich but revenue is growing 15% — so the market's paying for growth. Without this synthesis, I'd have had to pull 6 different screens.\"*\n4. **Type `TSLA` + Enter** — INTEL refreshes instantly. Point at the verdict badge.\n5. **Type `TSLA OMON`** — full options chain fills the screen. *\"That's every AAPL strike, calls left, puts right, in-the-money highlighted.\"*\n6. **Type `CURV`** — yield curve chart. *\"Here's the US Treasury yield curve with today, a week ago, and a month ago overlaid. 2s-10s is +52 basis points — normal, not inverted.\"*\n7. **Type `WEI`** — world indices. *\"Global markets by region.\"*\n8. **Wrap** — *\"16 functions, tabs across the top like Bloomberg Launchpad, completely free. Clone the repo, run `.\u002Fsetup.sh`, done. Link in description.\"*\n\n### Shot list for the video\n- Terminal window (black, amber) — at least one wide shot\n- Command bar typing with autocomplete appearing\n- Clicking between tabs\n- The yield curve drawing itself after load\n- Scrolling the options chain\n- The INTEL verdict badge zoom-in\n\n---\n\n## Architecture (1 min)\n\n- **Python API**: `openbb-api` (FastAPI + Uvicorn) on port 6900. Exposes `\u002Fapi\u002Fv1\u002F...`  \n- **Frontend**: Vite + React + TypeScript on port 5173. Vite proxies `\u002Fapi` to the Python process.\n- **Data**: Yahoo Finance via OpenBB (no key). Free tier covers every function in this terminal today. Richer providers (fundamental data depth, unusual options flow, economic calendar) need keys.\n- **Signals**: plain-JS rules in `app\u002Fsrc\u002Flib\u002Fsignals.ts` — transparent, auditable, tweakable.\n\n```\n┌──────────┐  HTTP   ┌────────────────┐  HTTP   ┌──────────────┐\n│ Browser  │────────▶│ Vite dev (5173)│────────▶│ OpenBB (6900)│──▶ Yahoo, SEC, FRED…\n└──────────┘         │ + \u002Fapi proxy   │         └──────────────┘\n                     └────────────────┘\n```\n\n---\n\n## Known limits\n\n- **Polling, not streaming.** Yahoo Finance has no WebSocket in OpenBB, so quotes refresh every 3–60s depending on the panel. For live ticks you'd need a broker feed (IBKR, Alpaca) — not wired in yet.\n- **Yahoo symbol quirks.** A handful of Asian indices (`^N225`, `^HSI`, `^AXJO`, `^TWII`) and a few crypto tickers don't return via OpenBB's Yahoo provider; those cells show \"—\".\n- **Rules are heuristics.** The INTEL signals are rules of thumb, not predictions. Tweak the thresholds in `signals.ts` to match your own framework.\n- **Economic calendar, CPI, world news** need provider API keys (TradingEconomics, FRED, Biztoc). The UI handles the 401 gracefully.\n\n---\n\n## Adding API keys (optional)\n\n```bash\n# Edit this file\n~\u002F.openbb_platform\u002Fuser_settings.json\n```\n\n```json\n{\n  \"credentials\": {\n    \"fred_api_key\": \"…\",\n    \"fmp_api_key\": \"…\",\n    \"intrinio_api_key\": \"…\"\n  }\n}\n```\n\nRestart the API after changing (`.\u002Fstop.sh && .\u002Fstart.sh`).\n\n---\n\n## Repo layout\n\n```\nBBterminal\u002F\n├── setup.sh            # one-time install\n├── start.sh            # launch API + UI\n├── stop.sh             # kill both\n├── README.md\n├── .venv\u002F              # Python env (created by setup)\n├── OpenBB\u002F             # cloned upstream repo, for reference\n└── app\u002F                # the terminal UI\n    ├── src\u002F\n    │   ├── App.tsx\n    │   ├── components\u002F (CommandBar, WorkspaceTabs, FunctionPanel, StatusBar)\n    │   ├── functions\u002F  (CC, INTEL, DES, GP, QR, HP, FA, KEY, DVD, EE, NI,\n    │   │               WEI, MOV, OMON, CURV, FXC, CRYPTO, HELP)\n    │   ├── lib\u002F        (api.ts, signals.ts, functions.ts, format.ts, cn.ts)\n    │   └── store\u002F      (workspaceStore.ts)\n    └── tailwind.config.js\n```\n\n---\n\n## License\n\n- Your BBterminal code: yours to relicense.\n- OpenBB Platform: AGPL-v3 (upstream).\n- Yahoo Finance data: subject to Yahoo's terms — personal use only.\n","BB-Terminal 是一个免费的金融数据智能仪表盘，风格类似于彭博终端。其核心功能包括通过 OpenBB 平台接入超过 50 家数据提供商的 270 多个端点，提供琥珀色背景的终端用户界面，并内置规则引擎将原始数据转化为可解读的信号。项目基于 OpenBB、Vite、React 和 TypeScript 构建，利用 TradingView 的轻量级图表库展示数据。适用于需要快速获取并分析金融市场信息的场景，如股票研究、投资决策支持等。安装简便，支持 macOS、Linux（Windows 用户可通过 WSL 或 Git Bash 使用），且对 Python 和 Node.js 版本有一定要求。","2026-06-11 02:51:55","CREATED_QUERY"]