OpenHamster keeps the wheel turning in the background: symbol selection, prompt contracts, governance gates, paper-trading state, and audit history stay reviewable instead of hidden.

View Repository Read Docs
  • HK-only scope
  • MiniMax or mock provider
  • Deterministic governance
  • Local paper ledger
OpenHamster pixel hamster icon

Why

Built for evidence before capital.

Research With Context

Universe selection, macro context, and strategy prompts feed one reviewable market snapshot.

Governance With Reasons

Promotion and rejection are explicit outputs, not hidden side effects of an opaque agent loop.

Paper Trading With Audit

Orders, positions, NAV, and runtime events remain inspectable from the dashboard and event trail.

Flow

One controlled loop from research to paper execution.

Flow diagram for OpenHamster

Surface

Operator-facing dashboard views.

/command

Runtime heartbeat, slot focus, blockers, and paper summary.

/research

Proposal evidence pack, market rationale, debate, and quality report.

/paper

Active strategy, holdings, NAV curve, and execution explanations.

/audit

Decision timeline, universe changes, provider fallback events, and cause chain.

Start

Quick start.

Backend

pip install -e .[dev]
alembic upgrade head
openhamster-api

Frontend

npm install --prefix apps/web
npm run dev --prefix apps/web

Boundary

No broker execution. No auto live trading.

OpenHamster is intentionally constrained. Paper-trading success does not imply live-trading readiness, and old legacy runtime paths are not part of the public roadmap.

Architecture Notes Contributing