From 31eaa1f60f6896a5e40076994595cac885d0a610 Mon Sep 17 00:00:00 2001 From: staccDOTsol Date: Tue, 1 Sep 2026 04:34:51 -0400 Subject: [PATCH 1/3] docs: add OpenZoo LLM provider guide --- docs.json | 3 ++- openhands/usage/llms/llms.mdx | 1 + openhands/usage/llms/openzoo.mdx | 33 ++++++++++++++++++++++++++++++++ 3 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 openhands/usage/llms/openzoo.mdx diff --git a/docs.json b/docs.json index 0e3b3c47e..570e909ea 100644 --- a/docs.json +++ b/docs.json @@ -120,7 +120,8 @@ "openhands/usage/llms/litellm-proxy", "openhands/usage/llms/moonshot", "openhands/usage/llms/openai-llms", - "openhands/usage/llms/openrouter" + "openhands/usage/llms/openrouter", + "openhands/usage/llms/openzoo" ] } ] diff --git a/openhands/usage/llms/llms.mdx b/openhands/usage/llms/llms.mdx index b2270bb45..da8f1cf08 100644 --- a/openhands/usage/llms/llms.mdx +++ b/openhands/usage/llms/llms.mdx @@ -107,6 +107,7 @@ We have a few guides for running OpenHands with specific model providers: - [OpenAI](/openhands/usage/llms/openai-llms) - [OpenHands](/openhands/usage/llms/openhands-llms) - [OpenRouter](/openhands/usage/llms/openrouter) +- [OpenZoo](/openhands/usage/llms/openzoo) These pages remain the authoritative provider references for both the Agent SDK and the OpenHands interfaces. diff --git a/openhands/usage/llms/openzoo.mdx b/openhands/usage/llms/openzoo.mdx new file mode 100644 index 000000000..02935c014 --- /dev/null +++ b/openhands/usage/llms/openzoo.mdx @@ -0,0 +1,33 @@ +--- +title: OpenZoo +description: How to use OpenZoo models with OpenHands +--- + +## Using OpenZoo with OpenHands + +[OpenZoo](https://openzoo.fun) is an OpenAI-compatible provider with no signup: +the API key can be any value and usage is paid per call (by card, or +automatically via the x402 protocol). It offers a hosted endpoint and a local +gateway (`npx openzoo`, serving `http://localhost:8402/v1`). + +### Setup + +1. No account is needed. Use any API key value, e.g. `sk-openzoo`. +2. In the OpenHands UI Settings under the `LLM` tab, enable `Advanced` options + and configure: + +| Setting | Value | +| --- | --- | +| Custom Model | `openai/` (e.g. `openai/z-ai/glm-5.3-flash`) | +| Base URL | `https://api.openzoo.fun/v1` | +| API Key | `sk-openzoo` (any value) | + +Available models are listed (free) at +`GET https://api.openzoo.fun/v1/models` — ids are namespaced, like +`z-ai/glm-5.3-flash`. + +### Local gateway + +Run `npx openzoo` and set the Base URL to `http://localhost:8402/v1` instead — +the gateway pays per call from a local burner wallet, so the hosted endpoint is +never a dependency. From 71c1837c1e20f029d71d5b6c869a82a27520ab36 Mon Sep 17 00:00:00 2001 From: staccDOTsol Date: Wed, 2 Sep 2026 01:52:01 -0400 Subject: [PATCH 2/3] =?UTF-8?q?docs:=20openzoo=20=E2=80=94=20local=20proxy?= =?UTF-8?q?=20is=20the=20setup=20path;=20hosted=20endpoint=20needs=20a=20s?= =?UTF-8?q?ubscription=20key?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- openhands/usage/llms/openzoo.mdx | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/openhands/usage/llms/openzoo.mdx b/openhands/usage/llms/openzoo.mdx index 02935c014..6986dddc0 100644 --- a/openhands/usage/llms/openzoo.mdx +++ b/openhands/usage/llms/openzoo.mdx @@ -5,29 +5,31 @@ description: How to use OpenZoo models with OpenHands ## Using OpenZoo with OpenHands -[OpenZoo](https://openzoo.fun) is an OpenAI-compatible provider with no signup: -the API key can be any value and usage is paid per call (by card, or -automatically via the x402 protocol). It offers a hosted endpoint and a local -gateway (`npx openzoo`, serving `http://localhost:8402/v1`). +[OpenZoo](https://openzoo.fun) is an OpenAI-compatible provider with no +account. You run a small local proxy (`npx openzoo`) that pays for each +request over the x402 protocol from a local burner wallet; OpenHands talks to +the proxy like any other OpenAI-compatible endpoint. ### Setup -1. No account is needed. Use any API key value, e.g. `sk-openzoo`. +1. Start the proxy: `npx openzoo`. It listens on `http://localhost:8402/v1`. + `npx openzoo address` prints its wallet — fund it with USDC on Solana or + Base; `npx openzoo balance` shows what is left. 2. In the OpenHands UI Settings under the `LLM` tab, enable `Advanced` options and configure: | Setting | Value | | --- | --- | | Custom Model | `openai/` (e.g. `openai/z-ai/glm-5.3-flash`) | -| Base URL | `https://api.openzoo.fun/v1` | -| API Key | `sk-openzoo` (any value) | +| Base URL | `http://localhost:8402/v1` (from Docker: `http://host.docker.internal:8402/v1`) | +| API Key | `sk-openzoo` (the proxy ignores the key; any non-empty value) | Available models are listed (free) at -`GET https://api.openzoo.fun/v1/models` — ids are namespaced, like +`GET http://localhost:8402/v1/models` — ids are namespaced, like `z-ai/glm-5.3-flash`. -### Local gateway +### Hosted endpoint -Run `npx openzoo` and set the Base URL to `http://localhost:8402/v1` instead — -the gateway pays per call from a local burner wallet, so the hosted endpoint is -never a dependency. +`https://api.openzoo.fun/v1` answers HTTP 402 unless the caller pays x402 or +presents an OpenZoo subscription key (`ozk_live_…`). OpenHands cannot pay +x402 itself, so point it at the local proxy. From bb911c61e26bab8024159b980b91233d72178bb1 Mon Sep 17 00:00:00 2001 From: Jarett Dunn Date: Sat, 5 Sep 2026 11:04:30 +0000 Subject: [PATCH 3/3] docs: use bare model ids and the auto router in the OpenZoo example The OpenZoo catalog (GET /v1/models on the local proxy and on api.openzoo.fun) now publishes bare model ids such as claude-sonnet-5 and gpt-4o-mini plus an `auto` router; the OpenRouter-style `z-ai/glm-5.3-flash` id used here is no longer listed. Point the example at `auto` and describe the ids as they are served today. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_01EzonbkWvkoz39cugD42AiH --- openhands/usage/llms/openzoo.mdx | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/openhands/usage/llms/openzoo.mdx b/openhands/usage/llms/openzoo.mdx index 6986dddc0..9ed2415d7 100644 --- a/openhands/usage/llms/openzoo.mdx +++ b/openhands/usage/llms/openzoo.mdx @@ -20,13 +20,14 @@ the proxy like any other OpenAI-compatible endpoint. | Setting | Value | | --- | --- | -| Custom Model | `openai/` (e.g. `openai/z-ai/glm-5.3-flash`) | +| Custom Model | `openai/` (e.g. `openai/auto`) | | Base URL | `http://localhost:8402/v1` (from Docker: `http://host.docker.internal:8402/v1`) | | API Key | `sk-openzoo` (the proxy ignores the key; any non-empty value) | Available models are listed (free) at -`GET http://localhost:8402/v1/models` — ids are namespaced, like -`z-ai/glm-5.3-flash`. +`GET http://localhost:8402/v1/models` — ids are bare model names, like +`claude-sonnet-5` or `gpt-4o-mini`; `auto` lets the proxy pick a model per +request. ### Hosted endpoint