zeq CLI

Three ways in, one command core: the web CLI (zero install, in your browser), the native build (single-file Node script, self-hosted — no npm), and the Python SDK (single file, stdlib only — no pip). All speak to the same live kernel.

Native CLI works today

One line. Needs Node 18+. Drops a single file at ~/.zeq/bin/zeq, pins this origin as the default (override any time with --origin).

⚠ Run that one line. Don't open install.sh and paste its contents into a terminal — zsh trips over raw script text (event not found).
$ zeq tutorial                        # guided onboarding — 7 steps, progress saved
$ zeq signup "four memorable words"   # identity + machine + api key — the wizard issues
                                       # your ACCOUNT EQUATION (shown once — store it)
$ zeq                                 # interactive session (REPL): ↑ history, Tab completion
$ zeq compute NM19 mass=5 acceleration=2
$ zeq compute GR37 mass=1.98892e30 --json > sun.json
$ zeq verify sun.json                 # Ed25519 + independent recompute — the trust loop
$ zeq sdk                             # quickstart wired to YOUR key
$ zeq update                          # atomic self-update from your origin

Web CLI zero install

The exact module graph the Workbench runs, in your browser, signed in with your Zeq session.

Launch the web CLI →

Start with tutorial (7-step onboarding) or hello — a real one-shot compute that prints the CKO envelope.

Python & other languages works today

Python: one file, standard library only — no pip, no registry. Compute and verify receipts from any Python 3.8+:

# as a library
from zeq import Zeq
z = Zeq("https://zeq.dev", key="zeq_ak_...")   # or z.demo_key()
env = z.compute("NM19", mass=5, acceleration=2)
print(z.verify(env)["attestation"]["verdict"])         # → "agree"

Any other language: two honest paths, both first-class —

RESTThe entire kernel is plain HTTPS + JSON — POST /api/zeq/compute with a Bearer key, POST /api/attest to verify. Works from Go, Rust, Java, C#, R, curl, anything. zeq sdk prints ready-to-paste snippets wired to your key.
--json bridgeShell out to the CLI from any language: every command returns typed JSON + honest exit codes (0/1/2/127). subprocess.run(["zeq","compute","NM19","mass=5","acceleration=2","--json"]) and parse stdout.

Command reference

tutorialGuided 7-step onboarding — clock, mint identity + machine, compute, verify, entangled state, SDK link, go build. Progress persists across sessions.
signup "<phrase>"Create your account from the terminal: the wizard derives your ACCOUNT EQUATION, registers only its hash, mints ZID + state machine + api key.
signin <ZID>Equation login — @file, stdin, or a hidden multi-line paste prompt. The equation must match exactly.
compute <OP> k=v …Run operators; returns the signed CKO envelope. --dry-run previews cost; --json for machines.
verify <file | ->Both trust legs on any envelope: Ed25519 against the origin's node key + independent recompute via the verifier mesh.
sdkQuickstart wired to YOUR key — REST curl, JavaScript, Python, MCP server, kernel skill.
keys / keys mint / keys revokeDeveloper API keys for headless auth (raw key shown once).
machine mint "<equation>"Manual genesis from an equation you supply (signup derives one for you).
whoami · creditsIdentity, machine, tier · credits (fuel) + ZEQ envelopes.
pulse · timeCurrent Zeqond, phase, HulyaPulse status (canonical clock).
state head|audit|exploreWalk the entangled state — your machine's hash-linked audit chain.
contract …Deploy, fire, pause, export state contracts.
agents · skills · apisSpawn/tick LLM agents · synthesised skills · external APIs.
site · prd · oracle · healthHosted pages · PRD · transparency · api-core probe.
operators · examples · helpCatalogue (1,500+ operators) · 20+ recipes · deep help per command.
update · version · profileAtomic self-update from your origin · constants card · multi-fork profiles.

Economy note: compute is billed in credits (fuel — never transferable); each compute mints a ZEQ envelope, and paid-funded computes mint 80% of it to you as coins — the only transferable asset. Durations everywhere are Zeqonds (1 Z = 0.777 s, definitional) and mz.