Skip to content

P-U-C/b1e55ed

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

384 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

b1e55ed

b1e55ed

Tests License: MIT

📚 docs.b1e55ed.permanentupperclass.com — Full documentation


A sovereign trading intelligence system.

It's not a mechanism. It's an organism.

Mechanisms execute. Organisms adapt. b1e55ed learns from every signal, every trade, every regime shift. Conviction weights update. Producer scores evolve. The corpus grows. The system you deploy today is not the system running six months from now.

That's not a feature. That's the point.


How it works

One primitive: events. Everything is an event.

Producers emit signals. The brain synthesizes them into conviction. Execution acts on conviction. Every step writes to an append-only hash chain. The chain is the audit trail — not the logs, not the docs, not a dashboard that lies.

Producers → Brain → Execution
     ↑                    ↓
     └──── Compound ◄─────┘

What's built

Layer
Event core Append-only database with hash chain. Auditable by construction.
Brain Multi-domain synthesis. Regime-conditioned conviction scoring.
Execution Confidence-sensitive position sizing. Kill switch gating.
Backtest engine Walk-forward validation. FDR correction. Regime-conditioned results.
Contributors Signal provenance. Karma accounting. EAS attestations (roadmap).
Agent interfaces SSE event stream. MCP server. Signal attribution.
Flywheel Signal → attribution → karma → weight closed loop. Compounds automatically.
Cockpit 4-quadrant "what do I trade today" dashboard with HTMX 30s refresh.
Benchmarks 4 benchmark producers (momentum, flat, equal-weight, discretionary).
Oracle Public provenance endpoint. No auth. Anti-Goodhart by design.
CLI Full operator control plane.
REST API Mounted at /api/v1/. Token auth.

Quick Setup

Standalone (data engine only):

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

Full stack (AI assistant + Telegram alerts):

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

Deployment

Guide Who it's for
Standalone Operator Guide Data engine only — no AI dependency
Agent Operator Guide (OpenClaw) Full stack — AI assistant + Telegram alerts + heartbeats
Producer Configuration Guide Configure signal producers and symbol packs

New here? Start with the standalone guide.


Whitepapers

Document Audience Length
Technical Whitepaper Engineers, researchers 7,400 words
Summary Whitepaper Informed generalists 2,400 words
Capital Allocator Brief Investors, signal buyers 600 words

Start

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

The wizard handles identity, setup, and first run — no manual steps.

API + dashboard after setup:

b1e55ed api        # http://localhost:5050/api/v1/health
b1e55ed dashboard  # http://localhost:5051
b1e55ed report --stratification  # confidence band analysis

Running from source?

git clone https://github.com/P-U-C/b1e55ed.git
cd b1e55ed && uv sync
./b1e55ed wizard   # repo-root wrapper, no install needed

Getting started


Docs

Guide
How it works Plain-English overview — objectives, flywheel, benefits
Getting started Install and first run
Architecture System design and data flow
Configuration All config keys
CLI reference Full command reference
API reference REST endpoints
MCP integration Connect Claude/external agents to live producer signals
Agent interfaces SSE, MCP, signal attribution
Oracle Producer provenance for agents
Curator pipeline Ingest operator intel
Contributors Attribution, karma, attestations
Learning loop How the system compounds
Backtest engine Walk-forward and sweep
Security Key management, kill switch
Deployment Production setup
Developers Contributing and extending
OpenClaw integration Operator layer

Permanent Upper Class

About

Sovereign AI trading intelligence

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors