CLI Setup

The halot CLI manages requester, provider, and verifier workspaces, service registration, quote creation, job funding, assignment streaming, and on-chain registry interactions.

Installation

npm install -g @halot/cli

# or run without a global install
npx @halot/cli --help

Network Defaults

The CLI is file-driven. Provider, service, verifier, and wallet state live in the generated workspace files, while protocol defaults such as registry addresses, RPC endpoints, SPACE ID routing, and Stellar passphrases ship with the CLI and SDK.

Requester Commands

$ halot requester init [--testnet|--mainnet] — Create a requester workspace

$ halot quote --service svc_... --input '{...}' — Fetch a quote directly from the server

$ halot job create --service svc_... --input '{...}' — Quote, prepare, fund, and confirm a job

Provider Commands

$ halot provider init [--testnet|--mainnet] — Create provider config and wallet files for one cluster

$ halot provider register — Publish provider config to storage, anchor it onchain, and run mainnet identity steps when enabled

$ halot provider update — Re-anchor mutable provider config after editing halot.provider.json

$ halot provider run — Open the provider assignment stream and submit results for worker-backed services

$ halot provider stats — Fetch provider job stats

Service Commands

$ halot service init --name "GPT-5.4 Text" — Create a local service draft

$ halot service register --file service-001.json — Register a local service draft on Halot

$ halot service list — List services registered for the current provider

$ halot service update <serviceId> — Re-anchor a registered service after editing its local file

$ halot service remove <serviceId> — Remove a service from the network

Verifier Commands

$ halot verifier init [--testnet|--mainnet] — Create verifier config, model config, inference template, and specializations for one cluster

$ halot verifier register — Register verifier identity and lock native 0G stake in the verifier registry

$ halot verifier run — Open the verifier assignment stream and submit attestations

$ halot verifier stats — Fetch verifier stats

$ halot verifier unstake [--claim] — Request cooldown or withdraw stake after cooldown

Job Commands

$ halot job watch <jobId> — Poll until the job reaches a terminal state

$ halot job result <jobId> — Fetch the final result, attestations, and settlement summary

$ halot browse [--service svc_...] — Discover providers and services from the server