AI
The `hanzo ai` commands.
Also for this capability: API · CLI · MCP · SDKs
Hanzo AI — the model API on /v1 (/v1/chat/completions, /v1/messages, /v1/models and the rest of hanzoai/ai's surface) — mounted into a cloud binary with the money, ingest and telemetry callbacks cloud BUILDS but cannot INSTALL.
hanzo models listEvery command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.
| Command | What it does |
|---|---|
hanzo ai account | Account |
hanzo ai activities | List activities |
hanzo ai answer | Answer |
hanzo ai feedback | Attaches a per-request outcome reward to the routing decision that served request_id — the enso training loop's quality… |
hanzo ai k8s-status | K8s Status |
hanzo ai prometheus | Prometheus |
hanzo ai signin | Signin |
hanzo ai signout | Signout |
hanzo ai system | System |
hanzo ai version | Version |
hanzo audio foley | Serves the generative audio verbs — /v1/audio/voice (TTS), /music, /foley — that the Zen family serves natively. |
hanzo audio music | Serves the generative audio verbs — /v1/audio/voice (TTS), /music, /foley — that the Zen family serves natively. |
hanzo audio speech | The OpenAI-compatible TTS endpoint (POST /v1/audio/speech). |
hanzo audio transcriptions | The OpenAI-compatible STT endpoint (POST /v1/audio/transcriptions, multipart: file + model [+ language +… |
hanzo audio voice | Serves the generative audio verbs — /v1/audio/voice (TTS), /music, /foley — that the Zen family serves natively. |
hanzo chat completions | Implements the OpenAI-compatible chat completions API |
hanzo chat create | Implements the OpenAI-compatible chat completions API |
hanzo chat public | Serves one completion to a caller with no account. |
hanzo completions create | Implements the OpenAI-compatible chat completions API |
hanzo embeddings create | Implements POST /v1/embeddings (OpenAI-compatible). |
hanzo images generations | Implements POST /v1/images/generations (OpenAI-compatible). |
hanzo messages count_tokens | Implements POST /v1/messages/count_tokens. |
hanzo messages create | Implements the Anthropic Messages API. |
hanzo models list | Returns the list of available models from the routing table. |
hanzo models providers | Public, secret-free list of the providers serving the models that GET /v1/models lists — the same source, projected. |
hanzo rerank create | Implements POST /v1/rerank (Cohere/Jina-compatible). |
hanzo responses create | Implements POST /v1/responses. |
hanzo videos generations | Implements POST /v1/videos/generations — the ASYNC create. |
access
| Command | What it does |
|---|---|
hanzo models access create <model> | Records the caller's waitlist request for a gated model and answers their new standing. |
hanzo models access get <model> | Returns the caller's own standing for a gated model: "granted", "requested", or empty when they have never asked. |
articles
| Command | What it does |
|---|---|
hanzo ai articles create | Create a article |
hanzo ai articles global | List articles across tenants |
hanzo ai articles list | List articles |
hanzo ai articles owner get <owner> <name> | Retrieve a article |
hanzo ai articles owner rm <owner> <name> | Delete a article |
hanzo ai articles owner set <owner> <name> | Replace a article |
hanzo ai articles owner update <owner> <name> | Update a article |
assets
| Command | What it does |
|---|---|
hanzo ai assets create | Create a asset |
hanzo ai assets list | List assets |
hanzo ai assets owner get <owner> <name> | Retrieve a asset |
hanzo ai assets owner rm <owner> <name> | Delete a asset |
hanzo ai assets owner scan <owner> <name> | Scan (asset) |
hanzo ai assets owner set <owner> <name> | Replace a asset |
hanzo ai assets owner update <owner> <name> | Update a asset |
hanzo ai assets scan | Scan (asset) |
chats
| Command | What it does |
|---|---|
hanzo ai chats create | Create a chat |
hanzo ai chats global | List chats across tenants |
hanzo ai chats list | List chats |
hanzo ai chats owner get <owner> <name> | Retrieve a chat |
hanzo ai chats owner rm <owner> <name> | Delete a chat |
hanzo ai chats owner set <owner> <name> | Replace a chat |
hanzo ai chats owner update <owner> <name> | Update a chat |
connections
| Command | What it does |
|---|---|
hanzo ai connections add <provider> | Disconnects a third-party AI account: it deactivates the org's row so completion resolution falls back to the global… |
hanzo ai connections authorize <provider> | Begins an OAuth connection for the caller's org: it binds the org into a signed state and sends the caller to the… |
hanzo ai connections callback <provider> | Completes OAuth: the org is recovered from the SIGNED state (not a header), the code is exchanged for a token, the… |
hanzo ai connections create | Connects (or reconnects) a third-party AI account for the org by sealing the supplied key into KMS and upserting the… |
hanzo ai connections list | Lists the org's connectable AI accounts and whether each is currently connected. |
hanzo ai connections rm <provider> | Disconnects a third-party AI account: it deactivates the org's row so completion resolution falls back to the global… |
hanzo ai connections usage <provider> | Imports the caller org's usage for a connected third-party account. |
content
| Command | What it does |
|---|---|
hanzo videos content <id> | Implements GET /v1/videos/{id}/content — download the finished MP4. |
dashboards
| Command | What it does |
|---|---|
hanzo ai dashboards agents | Dashboards Agents |
hanzo ai dashboards vm | Dashboards Vm |
deployments
| Command | What it does |
|---|---|
hanzo ai deployments create | Create a application |
hanzo ai deployments list | List deployments |
hanzo ai deployments owner deploy <owner> <name> | Deploy (application) |
hanzo ai deployments owner get <owner> <name> | Retrieve a application |
hanzo ai deployments owner rm <owner> <name> | Delete a application |
hanzo ai deployments owner set <owner> <name> | Replace a application |
hanzo ai deployments owner undeploy <owner> <name> | Undeploy (application) |
hanzo ai deployments owner update <owner> <name> | Update a application |
files
| Command | What it does |
|---|---|
hanzo ai files activate | Activate (file) |
hanzo ai files active | Active (file) |
hanzo ai files create | Create a file |
hanzo ai files global | List files across tenants |
hanzo ai files list | List files |
hanzo ai files owner get <owner> <name> | Retrieve a file |
hanzo ai files owner rm <owner> <name> | Delete a file |
hanzo ai files owner set <owner> <name> | Replace a file |
hanzo ai files owner update <owner> <name> | Update a file |
hanzo ai files owner vectors <owner> <name> | Vectors (file) |
hanzo ai files upload | Upload (file) |
finetune
| Command | What it does |
|---|---|
hanzo ai finetune cancel | Deletes the TrainJob CR, meters the GPU-hours used so far, and marks the job cancelled. |
hanzo ai finetune deploy | Serves a completed job's checkpoints and registers the result as a routable model on api.hanzo.ai. |
hanzo ai finetune hf datasets | Proxies a HuggingFace dataset search (dataset picker). |
hanzo ai finetune hf models | Proxies a HuggingFace model search (base-model picker). |
hanzo ai finetune hf repo | Returns a repo's detail (files, gated/private state). |
hanzo ai finetune job | Returns one job with refreshed live status. |
hanzo ai finetune jobs create | Validates the request, resolves efficient defaults, persists the job, and submits a real TrainJob CR. |
hanzo ai finetune jobs get | Returns the org's jobs, refreshing live status for active ones. |
hanzo ai finetune presets | Returns the new-job catalog plus, when a selection is passed (?baseModel&method&task&preset[&datasetExamples]), the… |
forms
| Command | What it does |
|---|---|
hanzo ai forms create | Create a form |
hanzo ai forms data | Data (form) |
hanzo ai forms global | List forms across tenants |
hanzo ai forms list | List forms |
hanzo ai forms owner get <owner> <name> | Retrieve a form |
hanzo ai forms owner rm <owner> <name> | Delete a form |
hanzo ai forms owner set <owner> <name> | Replace a form |
hanzo ai forms owner update <owner> <name> | Update a form |
get
| Command | What it does |
|---|---|
hanzo videos get <id> | Implements GET /v1/videos/{id} — poll a job's status. |
graphs
| Command | What it does |
|---|---|
hanzo ai graphs create | Create a graph |
hanzo ai graphs global | List graphs across tenants |
hanzo ai graphs list | List graphs |
hanzo ai graphs owner get <owner> <name> | Retrieve a graph |
hanzo ai graphs owner rm <owner> <name> | Delete a graph |
hanzo ai graphs owner set <owner> <name> | Replace a graph |
hanzo ai graphs owner update <owner> <name> | Update a graph |
mcp
| Command | What it does |
|---|---|
hanzo ai mcp tools | Tools reports what THIS PROCESS's MCP server carries: how many tools its own registry projects, optionally their names,… |
memory
| Command | What it does |
|---|---|
hanzo ai memory delete | Delete one of the authenticated user's memories |
hanzo ai memory facts | List the authenticated user's stored facts |
hanzo ai memory list | List the authenticated user's memories, newest first |
hanzo ai memory recall | Recall recent/relevant memories for context injection; with q it |
hanzo ai memory remember | Store a memory for the authenticated user |
hanzo ai memory search | Search the authenticated user's memories (semantic, text fallback) |
hanzo ai memory update | Update one of the authenticated user's memories |
messages
| Command | What it does |
|---|---|
hanzo ai messages create | Create a message |
hanzo ai messages global | List messages across tenants |
hanzo ai messages list | List messages |
hanzo ai messages owner answer <owner> <name> | Answer (message) |
hanzo ai messages owner get <owner> <name> | Retrieve a message |
hanzo ai messages owner rm <owner> <name> | Delete a message |
hanzo ai messages owner set <owner> <name> | Replace a message |
hanzo ai messages owner update <owner> <name> | Update a message |
hanzo ai messages welcome | Welcome (message) |
nodes
| Command | What it does |
|---|---|
hanzo ai nodes create | Create a node |
hanzo ai nodes list | List nodes |
hanzo ai nodes owner get <owner> <name> | Retrieve a node |
hanzo ai nodes owner rm <owner> <name> | Delete a node |
hanzo ai nodes owner set <owner> <name> | Replace a node |
hanzo ai nodes owner tunnel create <owner> <name> | Tunnel (node) |
hanzo ai nodes owner tunnel get <owner> <name> | Tunnel (node) |
hanzo ai nodes owner update <owner> <name> | Update a node |
org
| Command | What it does |
|---|---|
hanzo ai org settings clear | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings create | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings get | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings list clear | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings list create | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings list get | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings list patch | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings list replace | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings patch | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai org settings replace | The HTTP transport binding for the RESTful router-config nouns… |
preferences
| Command | What it does |
|---|---|
hanzo ai preferences patch | Preferences |
hanzo ai preferences replace | Preferences |
providers
| Command | What it does |
|---|---|
hanzo ai providers create | Create a provider |
hanzo ai providers global | List providers across tenants |
hanzo ai providers list | List providers |
hanzo ai providers mcp-tools | Mcp Tools (provider) |
hanzo ai providers owner get <owner> <name> | Retrieve a provider |
hanzo ai providers owner rm <owner> <name> | Delete a provider |
hanzo ai providers owner set <owner> <name> | Replace a provider |
hanzo ai providers owner update <owner> <name> | Update a provider |
rag
| Command | What it does |
|---|---|
hanzo ai rag context | Return every stored chunk of one file_id (full document context). |
hanzo ai rag delete | Delete all chunks of one or more uploaded files (by file_id) from the owner's Search+Vector index. |
hanzo ai rag embed | Parse, chunk, and embed one uploaded file under its file_id into the unified Search+Vector index, scoped to the… |
hanzo ai rag ingest | Unified RAG ingest: parse + chunk + embed documents and pipe them to BOTH Hanzo Vector (semantic) AND Hanzo Search… |
hanzo ai rag query | Retrieve the top-K chunks relevant to a query, scoped to a single uploaded file (file_id). |
hanzo ai rag query-multiple | Retrieve the top-K chunks relevant to a query, scoped to a SET of uploaded files (file_ids). |
records
| Command | What it does |
|---|---|
hanzo ai records batch | Batch (record) |
hanzo ai records commit | Commit (record) |
hanzo ai records commit-second | Commit Second (record) |
hanzo ai records create | Create a record |
hanzo ai records list | List records |
hanzo ai records owner get <owner> <name> | Retrieve a record |
hanzo ai records owner rm <owner> <name> | Delete a record |
hanzo ai records owner set <owner> <name> | Replace a record |
hanzo ai records owner update <owner> <name> | Update a record |
hanzo ai records query | Query (record) |
hanzo ai records query-second | Query Second (record) |
remote-connections
| Command | What it does |
|---|---|
hanzo ai remote-connections create | Create a connection |
hanzo ai remote-connections list | List remote-connections |
hanzo ai remote-connections owner get <owner> <name> | Retrieve a connection |
hanzo ai remote-connections owner rm <owner> <name> | Delete a connection |
hanzo ai remote-connections owner set <owner> <name> | Replace a connection |
hanzo ai remote-connections owner start <owner> <name> | Start (connection) |
hanzo ai remote-connections owner stop <owner> <name> | Stop (connection) |
hanzo ai remote-connections owner update <owner> <name> | Update a connection |
router
| Command | What it does |
|---|---|
hanzo ai router artifact-meta clear | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router artifact-meta create | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router artifact-meta get | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router artifact-meta patch | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router artifact-meta replace | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router data clear | Router Data |
hanzo ai router data get | Router Data |
hanzo ai router defaults clear | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router defaults create | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router defaults get | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router defaults patch | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router defaults replace | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router history | Returns the router-improvement time-series. |
hanzo ai router judge-panel | Returns the LIVE Mean-Field Judge Panel state: the configured panel + dynamic judge posture (enabled/sample) resolved… |
hanzo ai router ledger clear | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router ledger create | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router ledger get | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router ledger patch | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router ledger replace | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router policy clear | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router policy create | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router policy get | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router policy patch | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router policy replace | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router rewards clear | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router rewards create | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router rewards get | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router rewards patch | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router rewards replace | The HTTP transport binding for the RESTful router-config nouns… |
hanzo ai router stats | Returns the router observability aggregate. |
routes
| Command | What it does |
|---|---|
hanzo ai routes create | Create a model-route |
hanzo ai routes list | List routes |
hanzo ai routes owner get <owner> <name> | Retrieve a model-route |
hanzo ai routes owner rm <owner> <name> | Delete a model-route |
hanzo ai routes owner set <owner> <name> | Replace a model-route |
hanzo ai routes owner update <owner> <name> | Update a model-route |
scales
| Command | What it does |
|---|---|
hanzo ai scales create | Create a scale |
hanzo ai scales global | List scales across tenants |
hanzo ai scales list | List scales |
hanzo ai scales owner get <owner> <name> | Retrieve a scale |
hanzo ai scales owner rm <owner> <name> | Delete a scale |
hanzo ai scales owner set <owner> <name> | Replace a scale |
hanzo ai scales owner update <owner> <name> | Update a scale |
hanzo ai scales public | Public (scale) |
scans
| Command | What it does |
|---|---|
hanzo ai scans create | Create a scan |
hanzo ai scans list | List scans |
hanzo ai scans owner get <owner> <name> | Retrieve a scan |
hanzo ai scans owner rm <owner> <name> | Delete a scan |
hanzo ai scans owner set <owner> <name> | Replace a scan |
hanzo ai scans owner update <owner> <name> | Update a scan |
signin-sessions
| Command | What it does |
|---|---|
hanzo ai signin-sessions create | Create a session |
hanzo ai signin-sessions duplicated | Duplicated (session) |
hanzo ai signin-sessions list | List signin-sessions |
hanzo ai signin-sessions owner get <owner> <name> | Retrieve a session |
hanzo ai signin-sessions owner rm <owner> <name> | Delete a session |
hanzo ai signin-sessions owner set <owner> <name> | Replace a session |
hanzo ai signin-sessions owner update <owner> <name> | Update a session |
stores
| Command | What it does |
|---|---|
hanzo ai stores create | Create a store |
hanzo ai stores global | List stores across tenants |
hanzo ai stores list | List stores |
hanzo ai stores names | Names (store) |
hanzo ai stores owner get <owner> <name> | Retrieve a store |
hanzo ai stores owner rm <owner> <name> | Delete a store |
hanzo ai stores owner set <owner> <name> | Replace a store |
hanzo ai stores owner update <owner> <name> | Update a store |
hanzo ai stores owner vectors <owner> <name> | Vectors (store) |
hanzo ai stores providers | Providers (store) |
tasks
| Command | What it does |
|---|---|
hanzo ai tasks create | Create a task |
hanzo ai tasks global | List tasks across tenants |
hanzo ai tasks list | List tasks |
hanzo ai tasks owner analyze <owner> <name> | Analyze (task) |
hanzo ai tasks owner document <owner> <name> | Document (task) |
hanzo ai tasks owner get <owner> <name> | Retrieve a task |
hanzo ai tasks owner rm <owner> <name> | Delete a task |
hanzo ai tasks owner set <owner> <name> | Replace a task |
hanzo ai tasks owner update <owner> <name> | Update a task |
templates
| Command | What it does |
|---|---|
hanzo ai templates create | Create a template |
hanzo ai templates list | List templates |
hanzo ai templates owner get <owner> <name> | Retrieve a template |
hanzo ai templates owner rm <owner> <name> | Delete a template |
hanzo ai templates owner set <owner> <name> | Replace a template |
hanzo ai templates owner update <owner> <name> | Update a template |
traffic
| Command | What it does |
|---|---|
hanzo ai traffic globe | Returns the PUBLIC live request-geo aggregate for the world.hanzo.ai "Hanzo mode" globe: WHERE requests to api.hanzo.ai… |
training-contribution
| Command | What it does |
|---|---|
hanzo ai training-contribution get | Training Contribution |
hanzo ai training-contribution patch | Training Contribution |
hanzo ai training-contribution replace | Training Contribution |
tree-files
| Command | What it does |
|---|---|
hanzo ai tree-files create | Create a tree-file |
hanzo ai tree-files owner rm <owner> <name> | Delete a tree-file |
hanzo ai tree-files owner set <owner> <name> | Replace a tree-file |
hanzo ai tree-files owner update <owner> <name> | Update a tree-file |
usages
| Command | What it does |
|---|---|
hanzo ai usages by-user | By User (usage) |
hanzo ai usages cloud | Cloud (usage) |
hanzo ai usages get | List usages |
hanzo ai usages range | Range (usage) |
hanzo ai usages user-names | User Names (usage) |
vectors
| Command | What it does |
|---|---|
hanzo ai vectors all | All (vector) |
hanzo ai vectors create | Create a vector |
hanzo ai vectors global | List vectors across tenants |
hanzo ai vectors list | List vectors |
hanzo ai vectors owner get <owner> <name> | Retrieve a vector |
hanzo ai vectors owner rm <owner> <name> | Delete a vector |
hanzo ai vectors owner set <owner> <name> | Replace a vector |
hanzo ai vectors owner update <owner> <name> | Update a vector |
videos
| Command | What it does |
|---|---|
hanzo ai videos create | Create a video |
hanzo ai videos global | List videos across tenants |
hanzo ai videos list | List videos |
hanzo ai videos owner get <owner> <name> | Retrieve a video |
hanzo ai videos owner rm <owner> <name> | Delete a video |
hanzo ai videos owner set <owner> <name> | Replace a video |
hanzo ai videos owner update <owner> <name> | Update a video |
hanzo ai videos upload | Upload (video) |
workflows
| Command | What it does |
|---|---|
hanzo ai workflows create | Create a workflow |
hanzo ai workflows global | List workflows across tenants |
hanzo ai workflows list | List workflows |
hanzo ai workflows owner get <owner> <name> | Retrieve a workflow |
hanzo ai workflows owner rm <owner> <name> | Delete a workflow |
hanzo ai workflows owner set <owner> <name> | Replace a workflow |
hanzo ai workflows owner update <owner> <name> | Update a workflow |
How is this guide?