Quickstart

This is the shortest path to a running local brain and your first signal.

Install

curl -sSf https://raw.githubusercontent.com/P-U-C/b1e55ed/main/install.sh | bash

After install, b1e55ed should be available in your PATH.

Run the wizard

b1e55ed wizard

Running from source? Use ./b1e55ed wizard or uv run b1e55ed wizard.

After the wizard completes, choose your deployment mode:

Start the brain

b1e55ed brain

This initializes / opens your local append-only event store (SQLite by default).

Publish your first signal

b1e55ed signal "BTC breakout — confirmed on-chain" \
  --symbols BTC \
  --direction bullish \
  --conviction 7

(Optional) API + dashboard

If you want a UI and HTTP API:

# Terminal 1
export B1E55ED_API__AUTH_TOKEN="your-secret-token"
b1e55ed api

# Terminal 2
b1e55ed dashboard

The repo also contains a longer local guide at docs/getting-started.md.