HOOX

Ultra-low-latency edge trading framework, built on Cloudflare Workers.

HOOX is a production-grade, open-source algorithmic trading stack. Signals are validated and executed inside V8 isolates colocated with exchange APIs, delivering a median signal-to-ack latency of ~22 ms from 330+ global points of presence. No servers, no vendor lock-in.

Ecosystem

HOOX is the edge trading framework. Sister products on the same site:

                    https://hoox.sh
           ┌──────────────┼──────────────┐
           ▼              ▼              ▼
         HOOX            PYNE           AXIS
    (edge execution)  (Pine engine)  (charting UI)
           │              │              │
           └──────────────┴──────────────┘
                    trade signals / eval API

Install

The CLI is distributed as a Bun package. Bun is required — the CLI is a Bun bundle and will not run under Node.

# 1. Install Bun (if you don't have it)
curl -fsSL https://bun.sh/install | bash

# 2. Install the CLI globally
bun add -g @hoox-sh/hoox-cli

# 3. Clone the workspace (workers are git submodules — use --recursive)
git clone --recursive https://github.com/hoox-sh/hoox.git
cd hoox

# 4. Bootstrap: provisions D1, KV, secrets, and deploys in dependency order
hoox onboard

# 5. Later: CLI works from any directory (path is remembered after first use)
cd ~/Videos
hx doctor          # Source: remembered · Runtime root: …/hoox

hoox onboard is the recommended path. It writes wrangler.jsonc, collects secrets, generates keys, applies the D1 schema, pushes secrets, and deploys the dashboard. Alias: hx.

The CLI auto-detects the monorepo (HOOX_REPO → walk up from cwd → ~/.hoox/config/monorepo.json → ~/.hoox/repo), saves the path, and chdirs so you can run hx from any folder.

Prerequisites

Other install paths

From source (full monorepo). Canonical path for contributors and operators who need the full worker mesh.

git clone --recursive https://github.com/hoox-sh/hoox.git hoox-trading
cd hoox-trading
bun install
hoox onboard
hoox check health

If you cloned without submodules: git submodule update --init --recursive (or hoox clone --all).

Local dev with Docker. Mirrors the production Service Binding topology. Only the gateway (hoox) and dashboard expose host ports.

docker compose --profile workers up      # workers only
docker compose --profile dashboard up    # dashboard + deps
docker compose --profile full up         # full stack
# or: hoox dev start --runtime docker

Production / self-hosted. For demos, local testing, or air-gapped runs. Not a full substitute for the Cloudflare edge — Durable Objects, Vectorize, and Workers AI are unavailable self-hosted.

bun run docker:prod
# or manually:
docker build -f Dockerfile.prod . --tag hoox:prod
docker run -p 8080:8080 -e HOOX_SERVER_API_KEY=your-key hoox:prod

The self-hosted gateway requires HOOX_SERVER_API_KEY for authenticated requests.

Deploy to Cloudflare (production). Onboard provisions infrastructure; deploy ships the workers.

hoox onboard
hoox deploy all --auto
hoox deploy telegram-webhook
hoox deploy update-internal-urls
hoox deploy kv-config
hoox check health

Non-interactive: hoox onboard --token cfut_xxx --account xxx --preset full.

Guides: Installation · Deploy

Quick path (edge)

# Bun only — `npm install -g @hoox-sh/hoox-cli` aborts (workspace:* optionalDependency).
# After `curl -fsSL https://bun.sh/install | bash`, put ~/.bun/bin on PATH.
bun add -g @hoox-sh/hoox-cli
git clone --recursive https://github.com/hoox-sh/hoox.git && cd hoox
hoox onboard
hoox deploy all --auto
hoox check health

Interfaces — CLI · TUI · Dashboard

The same stack, three surfaces. CLI for automation and CI, TUI for terminal operations, dashboard for visual monitoring and risk.

Full set (every view, command group, and page): docs.hoox.sh → Interface gallery · files in docs/images/.

CLI

The primary operator interface. Running hoox with no arguments launches the interactive menu; hoox tui opens the full OpenTUI operations center.

Full reference: CLI docs · packages/cli/README.md · hoox.sh/cli

TUI

hoox tui
# monorepo: bun run tui
# packages/tui: bun run dev | bun run build && bun run start

Dashboard

hoox dev dashboard          # or: hoox dashboard dev  → localhost:3000
hoox deploy dashboard       # or: hoox dashboard deploy
docker compose --profile dashboard up   # localhost:8794

Production URL: https://<your-subdomain>.workers.dev (set during onboard). Requires the gateway, d1-worker, and agent-worker for full functionality. The dashboard runs on Cloudflare Workers via OpenNext, not Pages.

Architecture

Eleven compute surfaces (ten Workers + the OpenNext dashboard) communicate over Cloudflare Service Bindings — direct isolate-to-isolate calls with sub-millisecond overhead, no public internet traversal, no TLS handshakes, no DNS resolution between components.

Only the gateway and dashboard are public. Every other worker is a private isolate, reachable only via Cloudflare Service Bindings (except tooling auth such as pyne-worker API_KEY). Each worker is a git submodule with its own README and GitHub description; see docs → Workers for operator isolate profiles.

graph LR
  TV[TradingView] -->|Webhook| GW[hoox Gateway]
  GW -->|Binding| TW[trade-worker]
  GW -->|Queue failover| Q[Queues]
  TW -->|Signed REST| EX[Exchanges]
  AW[agent-worker] -->|Risk| TW
  TW -->|Notify| TGW[telegram-worker]

Docs & research

Free forever. Open source.

HOOX is free to use, self-host, and modify — no paid core, no artificial limits on the open mesh. Deploy the full edge-native stack on Cloudflare's free tier for typical retail volume. Code is Apache-2.0; docs and papers are CC BY 4.0. Built for traders and operators who want production-grade infrastructure without a vendor lock-in tax.

Security, cost & disclaimer

Zero-trust mesh: internal workers have no public HTTP. Secrets are injected into V8 isolates at runtime. Free-tier capable for typical retail volume. Operator management paths can sit behind Cloudflare Access / tunnel — verify with hoox doctor --security and hoox tunnel check.

Disclaimer. Educational and research use. Trading involves substantial risk of loss. Not financial advice. See DISCLAIMER.md and LICENSE.

Open core: Apache-2.0 (code) · CC BY 4.0 (docs/papers).

The HOOX Stack — all products & sister projects

Everything under github.com/hoox-sh — one open trading stack on hoox.sh:

                    https://hoox.sh
           ┌──────────────┼──────────────┐
           ▼              ▼              ▼
         HOOX            PYNE           AXIS
    (edge execution)  (Pine engine)  (charting UI)
           │              │              │
           └──────────────┴──────────────┘
                    trade signals / eval API

Main products

PYNE satellites

AXIS satellites

HOOX execution & ops plane

Web

Ethos

• Independent & open — no proprietary chart host, no closed data services; evaluation never depends on TradingView®.
• Edge-first — compute colocated with exchanges on Cloudflare's global network.
• Local-first — AXIS runs fully offline (Pyodide); PYNE runs on your machine; HOOX self-hosts on the free tier.
• No vendor lock-in — open core, self-hostable, exportable.
• Batteries included — CLIs, LSP, dashboards, docs, and one-click deploy buttons ship in the box.

Disclaimer. Pine Script™ and TradingView® are trademarks of TradingView, Inc.; Cloudflare® is a trademark of Cloudflare, Inc. The HOOX stack is independent and is not affiliated with, authorized by, sponsored by, or endorsed by either company. Educational and research use; trading involves substantial risk of loss — this is not financial advice.

⚡ Powered by Cloudflare — Workers · D1 · R2 · KV · Queues · Analytics Engine · Workers AI · Browser Rendering

License

Open core: Apache-2.0 (code — see LICENSE-CODE) · CC BY 4.0 (docs & papers). Copyright © 2026 HOOX · jango-blockchained (hoox-sh).

🔋 Batteries included.