CLI reference
Every OGONG role is a standalone binary. All flags are exposed via --help on each binary;
this page is a curated index of the ones that matter. Defaults shown are the binaries’
built-in defaults.
ogong-validatord
Validator / audit node (QUIC).
| Flag | Default | Meaning |
|---|---|---|
--bind <addr> | 0.0.0.0:4533 | QUIC bind address |
--alpha <0..1> | 1.0 | audit coverage (1 = audit every reply) |
--s <prob> | 1.0 | verifier soundness |
--eps <prob> | 0.0 | verifier false-positive rate |
--beta <rate> | 0.001 | target lifetime false-ejection rate (Ville bound) |
--peer <host:port|cert> | - | audit-beacon peer (repeatable) |
--verifier-endpoint <host:port> | - | verifier to auto-dispatch audits to |
--verifier-cert <path> | - | pinned verifier cert (required with endpoint) |
--consensus | false | shared-ordered-log consensus driver |
Settlement env: OGONG_VALIDATOR_KEYPAIR, OGONG_VALIDATOR_CERT_OUT, OGONG_PROGRAM_ID,
OGONG_RPC_URL, OGONG_AUTHORITY_KEYPAIR, OGONG_MINT, OGONG_FEE_OWNERS, OGONG_QUORUM.
ogong-verifierd
Audit verifier: re-runs committed work on an independent engine.
| Flag | Default | Meaning |
|---|---|---|
--bind <addr> | 0.0.0.0:4544 | QUIC bind address |
--provider-url <url> | - | engine to re-run the committed work on |
--ref-url <url> | - | reference model endpoint (when distinct) |
--audio-engine-url <url> | - | audio engine for diffusion-audio audits |
--k <n> | 2 | sampled steps per audit |
--cert-out <path> | - | write the verifier’s pinned cert |
ogong-routerd
Marketplace match engine (QUIC).
| Flag | Default | Meaning |
|---|---|---|
--bind <addr> | 0.0.0.0:4544 | QUIC bind address |
--cert-out <path> | - | write bootstrap cert (DER) for gateways to pin |
--relay | off | put the router on the data path |
Env: OGONG_ROUTER_CERT_OUT, OGONG_ROUTER_RELAY.
ogong-gatewayd
OpenAI-compatible consumer front door.
| Flag | Default | Meaning |
|---|---|---|
--bind <addr> | 0.0.0.0:4546 | HTTP API bind address |
--router <addr> | 127.0.0.1:4544 | router’s QUIC address |
--router-cert <path> | - | router bootstrap cert to pin |
--max-price <u64> | u64::MAX | budget ceiling per 1k tokens (atomic OGONG units) |
Env: OGONG_ROUTER, OGONG_ROUTER_CERT, OGONG_GATEWAY_MAX_PRICE.
ogong-provider
Provider daemon. Subcommands:
| Subcommand | Purpose |
|---|---|
configure | write/update ~/.ogong-provider/config.json |
start | tunnel client (home GPU behind NAT) |
serve | direct HTTPS server (TEE / marketplace) |
local | standalone OpenAI + Ollama server (no network, no account) |
run | one-shot terminal REPL chat |
pull | download a model (--list to browse the catalog) |
show | print config (api key redacted) |
wallet | print Solana payout address |
quote | fetch a DCAP attestation quote (TDX) |
marketplace-register | submit identity to a marketplace operator |
Selected configure flags:
| Flag | Meaning |
|---|---|
--api-key | account API key (env OGONG_PROVIDER_API_KEY) |
--upstream <url> | adapter mode: forward to an existing OpenAI server |
--embedded-text <gguf> | spawn llama-server for this model |
--mmproj <gguf> | vision projector for the embedded text model |
--embedded-image <model> | spawn llamamp-image-server |
--embedded-music <gguf> | spawn ace-server |
--embedded-whisper <ggml> | spawn whisper-server (STT) |
--embedded-tts <gguf> | spawn the audio-server (TTS) |
--served-models <json> | on-demand LRU multi-model serving set |
--machine <name> | short machine id for your canonical provider id |
--join-network | opt into the verified-inference network |
--validator-endpoint <host:port> | validatord to push signed records to |
--listen / --cert / --key | bind + TLS for serve |
local flags: --model (repeatable), --mmproj, --n-ctx, --listen, --upstream,
--served-models.