Getting Started

b1e55ed is a CLI-first trading intelligence engine built around append-only events. This guide covers a local first run.

Quickstart (recommended)

Install

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

Setup wizard

b1e55ed wizard

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

Prerequisites

Python 3.11+
uv
SQLite (bundled on most systems)

Recommended:

A dedicated B1E55ED_MASTER_PASSWORD for encrypted-at-rest identity and keystore material.

Install

Option A: Installer script (recommended)

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

After install, b1e55ed is available globally in your PATH.

Option B: From source

git clone https://github.com/P-U-C/b1e55ed.git
cd b1e55ed
uv sync

From-source users can use ./b1e55ed (repo wrapper) or uv run b1e55ed for all commands.¹

Quick start (local)

Sequence: install → forge identity → setup → register contributor → run brain.

1) Forge an identity (The Forge)

The Forge derives an Ethereum identity with a 0xb1e55ed prefix. Required if you plan to use EAS attestations.

b1e55ed identity forge
b1e55ed identity show

Outputs:

.b1e55ed/identity.json (public identity)
.b1e55ed/forge_key.enc (private key material; protect it)

If you are not using EAS attestations, forging is optional.

2) Run setup

Setup writes config/user.yaml, initializes data/brain.db, and stores secrets in the keystore when available.

export B1E55ED_MASTER_PASSWORD="your-secure-password"
b1e55ed setup

3) (Optional) Configure EAS

EAS is used to create and verify off-chain attestations for contributors. Edit config/user.yaml:

eas:
  enabled: false
  mode: offchain
  rpc_url: "https://eth.llamarpc.com"
  eas_contract: "0xA1207F3BBa224E2c9c3c6D5aF63D0eb1582Ce587"
  schema_registry: "0xA7b39296258348C78294F95B872b282326A97BDF"
  schema_uid: ""               # set after schema registration
  attester_private_key: ""     # required for creating attestations

See: eas-integration.md.

4) Register a contributor

Contributors are the attribution unit for signals. Register via CLI:

b1e55ed contributors register --name "local-operator" --role operator

If EAS is enabled and eas.attester_private_key is configured:

b1e55ed contributors register --name "local-operator" --role operator --attest

See: contributors.md.

5) Run the brain

b1e55ed brain

Ingest your first signal:

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

See: curator.md for the full curator pipeline.

6) Start API + dashboard

API requires api.auth_token unless B1E55ED_INSECURE_OK=1 is set.

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

# Terminal 2
b1e55ed dashboard

# Dashboard: http://localhost:5051
# API:       http://localhost:5050/api/v1/health

Check agent interfaces:

curl -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/capabilities

This returns MCP tools, event domains, and producer capability summaries for onboarding.

Cockpit

After setup, visit the cockpit for a “what do I trade today” view:

open http://localhost:5050/cockpit

The cockpit shows top convictions, current regime, kill switch status, and recent P&L. Refreshes every 30 seconds via HTMX.

Reports

b1e55ed report --stratification   # confidence band analysis
b1e55ed report --cockpit-summary  # 7-day summary

Next steps

From-source: use ./b1e55ed command or uv run b1e55ed command. Installed users: just b1e55ed command. ↩

Getting Started

Setup

Producers

Operations

Features

Integrations

API Reference

Contributing

Reference

Getting Started

Getting Started

Quickstart (recommended)

Install

Setup wizard

Prerequisites

Install

Option A: Installer script (recommended)

Option B: From source

Quick start (local)

1) Forge an identity (The Forge)

2) Run setup

3) (Optional) Configure EAS

4) Register a contributor

5) Run the brain

6) Start API + dashboard

Cockpit

Reports

Next steps

​Getting Started

​Quickstart (recommended)

​Install

​Setup wizard

​Prerequisites

​Install

​Option A: Installer script (recommended)

​Option B: From source

​Quick start (local)

​1) Forge an identity (The Forge)

​2) Run setup

​3) (Optional) Configure EAS

​4) Register a contributor

​5) Run the brain

​6) Start API + dashboard

​Cockpit

​Reports

​Next steps

Footnotes

Getting Started

Quickstart (recommended)

Install

Setup wizard

Prerequisites

Install

Option A: Installer script (recommended)

Option B: From source

Quick start (local)

1) Forge an identity (The Forge)

2) Run setup

3) (Optional) Configure EAS

4) Register a contributor

5) Run the brain

6) Start API + dashboard

Cockpit

Reports

Next steps