README.md

A financial terminal for macOS. Type a short code, get an analyst function — about 138 of them, from company financials to options gamma to central-bank rate odds. Open source, runs entirely on your own machine, no subscription, no broker lock-in.

What is it · Preview · How it works · Functions · Honesty · Get started · Architecture

What is showMe?

showMe is a desktop financial terminal for macOS. Instead of hunting through menus, you drive it the way professional desks do: type a short function code into a command line and the matching analyst tool opens — FA for financial statements, GEX for options gamma exposure, WIRP for rate-hike odds, ECO for the economic calendar. There are about 138 functions spanning equities, options, bonds, FX, commodities, macro, news, and portfolio analytics.

It's the kind of professional terminal workflow you'd otherwise pay for in a Bloomberg Terminal — rebuilt as open source, running entirely on your own Mac, with no subscription and no broker lock-in.

Under the hood: a thin Tauri 2 (Rust) shell with a signed updater, a React + Vite UI, and a unified Python (FastAPI) sidecar that runs the function engine locally. Your data and keys never leave the machine.

Preview

Cockpit

Command palette — every function, one keystroke away

A function in context

How the terminal works

showMe has one core idea: a command line for markets. Press the palette shortcut, type a short code, hit enter — the function opens as a pane. No two functions look the same, because each is a purpose-built tool, but they all share the same launch gesture. If you know the code you want, you're one keystroke away; if you don't, the palette filters by name as you type.

A taste of the breadth — twelve representative codes:

Function catalog

About 138 functions across 14 categories. The exact set evolves; run npm run audit:functions for the live list. A representative slice by category:

Honest by design

A finance tool is only as trustworthy as the data behind it, so showMe is explicit about provenance.

• Data-mode pills. Every function pane labels where its numbers came from — live exchange/vendor data, delayed reference data, or a modeled value (e.g. option Greeks computed from a pricing model).
• Strict-zero gate. When a live source is unavailable, a function shows a PROVIDER_UNAVAILABLE state instead of inventing plausible-looking fake data. No silent fakery.

What showMe is — and isn't

Architecture

flowchart LR
    user(["You"]) -->|type a function code| react
    subgraph shell["Native shell"]
      tauri["Tauri 2 / Rust<br/>lifecycle · tray · menubar<br/>signed updater · Keychain"]
    end
    subgraph ui["UI process"]
      react["React + Vite + Tailwind<br/>zustand store<br/>command palette · i18n (12 langs)"]
    end
    subgraph backend["Python sidecar"]
      fastapi["FastAPI<br/>/api/health · /function-index · /fn/*"]
      engine["Function engine<br/>~138 functions · 14 categories"]
      data["Data layer<br/>providers · data-mode tagging"]
    end
    react -->|IPC| tauri
    tauri -->|spawn + HTTP| fastapi
    react -->|fetch JSON| fastapi
    fastapi --> engine --> data

    classDef shellNode fill:#dc572115,stroke:#dc5721,color:#dc5721
    classDef uiNode fill:#61dafb15,stroke:#61dafb,color:#1f6feb
    classDef beNode fill:#1f6bff15,stroke:#1f6bff,color:#1f6bff
    class tauri shellNode
    class react uiNode
    class fastapi,engine,data beNode

The Tauri shell discovers the sidecar's port from a single stdout line (SIDECAR_PORT=<u16>), restarts it up to 3× with exponential backoff on failure, and tears it down with a SIGTERM → 5 s grace → SIGKILL on quit. The WKWebView stays presentation-only; all native chrome (menubar, tray, dock, deep links, hotkeys, biometric unlock) lives in Rust.

Tech stack

Data sources

Most functions pull keyless, public data; a few are opt-in and need a key.

AI features (opt-in)

These are off by default and each needs its own model or key:

Get started

Download

Grab the latest signed build from Releases (showMe_0.1.1_aarch64.dmg, macOS Apple Silicon).

Run from source (dev)

# 1 — UI deps
cd ui && npm install && cd ..

# 2 — sidecar deps
cd backend && python3 -m pip install -e ".[dev]" && cd ..

# 3 — run dev (Tauri spawns the sidecar + UI together)
npm run tauri:dev

No Rust toolchain? Inspect the UI in the browser:

# terminal 1
cd backend && python3 -m showme.server --port 8765
# terminal 2
cd ui && npm run dev        # http://localhost:5173

Build a native bundle

bash packaging/build_sidecar.sh   # PyInstaller arm64 sidecar
npm run tauri:build               # .app + .dmg

Signing and notarization (optional, needs Apple credentials) live in packaging/sign.sh and packaging/notarize.sh.

Project layout

showMe/
├── tauri/        Native macOS shell (Rust): lifecycle, tray, menubar, deep-link, biometric
├── ui/           React + Vite + Tailwind + zustand frontend
│   └── src/      shell · panes · functions · command-palette · i18n (12 langs) · design-system
├── backend/      Python FastAPI sidecar + function engine
│   └── showme/   server · function_contracts · providers · brokers · agents
│       └── engine/functions/   the ~138 functions, in 14 category folders
├── packaging/    build / sign / notarize / dmg
├── scripts/      audits & dev tools (npm run audit:functions, …)
├── tests/        cross-cutting Playwright e2e
└── docs/         architecture, screenshots, specs, plans

Development & testing

npm run test:backend          # backend pytest suite
npm --workspace ui test       # UI vitest suite
npm run test:e2e:smoke:fast   # fast Playwright smoke path
npm run audit:functions       # live function inventory
npm run lint && npm run lint:py

Contributions welcome — see CONTRIBUTING.md and SECURITY.md.

License

MIT © 2026 Nazmi Efe Armutcu. Provided as-is, with no warranty. Not investment advice.