# Installation & availability

> AgenticFI client packages version 0.1.2 are public MIT-licensed alphas on npm under the alpha tag. OpenClaw and Hermes version 0.1.0 are public MIT alphas installable through their hosts’ native GitHub installers. The Python SDK remains source-only; ClawHub and PyPI listings are not claimed. Verify the package scope, `alpha` tag, version, and repository before installation.

## Fastest safe start

Requirements: Node.js 20.18 or newer, macOS or Linux, and a human-controlled terminal.

```bash
npm install --global @agenticfi/onchain-router-cli@alpha
onchain-router --version
onchain-router setup
onchain-router policy show
onchain-router unlock
onchain-router models
```

Version `0.1.2` is the current bounded public alpha. Install with the explicit npm `alpha` tag so your configuration communicates that release boundary. Before installation, verify that the package is under the `@agenticfi` scope and links to [AgenticFI/onchain-router-clients](https://github.com/AgenticFI/onchain-router-clients).

Setup, wallet import, funding, unlock, and policy widening are human-authority actions. Run them yourself in a direct terminal. Never put a private key, seed phrase, passphrase, payment payload, proxy bearer, or receipt capability in a prompt, command argument, environment variable, log, screenshot, or issue.

## Choose a public package

| Product        | Install                                                      | Status                                            |
| -------------- | ------------------------------------------------------------ | ------------------------------------------------- |
| TypeScript SDK | `npm install @agenticfi/onchain-router@alpha`                | Public npm alpha `0.1.2`                          |
| Buyer CLI      | `npm install --global @agenticfi/onchain-router-cli@alpha`   | Public npm alpha `0.1.2`                          |
| MCP server     | `npm install --global @agenticfi/onchain-router-mcp@alpha`   | Public npm alpha `0.1.2`                          |
| Local proxy    | `npm install --global @agenticfi/onchain-router-proxy@alpha` | Public npm alpha `0.1.2`                          |
| Buyer Runtime  | `npm install @agenticfi/onchain-router-buyer-core@alpha`     | Public npm alpha `0.1.2`; trusted-adapter authors |
| Smart routing  | `npm install @agenticfi/onchain-router-routing@alpha`        | Public npm alpha `0.1.2`; experimental            |

The Python SDK remains a source package that delegates paid execution to the matching CLI. It is not on PyPI.

| Integration | Best for | Availability | Source |
| --- | --- | --- | --- |
| [Direct API](https://onchainrouter.dev/docs/direct-api) | You already have an x402 buyer | Public API | Use the public API |
| [TypeScript SDK](https://onchainrouter.dev/docs/sdk-examples) | You are building a Node.js application | npm alpha · 0.1.2 | [GitHub](https://github.com/AgenticFI/onchain-router-clients) |
| [Buyer CLI](https://onchainrouter.dev/docs/cli) | You work in a terminal | npm alpha · 0.1.2 | [GitHub](https://github.com/AgenticFI/onchain-router-clients) |
| [MCP](https://onchainrouter.dev/docs/mcp) | Your agent uses native tools | npm alpha · 0.1.2 | [GitHub](https://github.com/AgenticFI/onchain-router-clients) |
| [Local OpenAI proxy](https://onchainrouter.dev/docs/proxy) | Your app accepts an OpenAI base URL | npm alpha · 0.1.2 | [GitHub](https://github.com/AgenticFI/onchain-router-clients) |
| [Agent Skill](https://onchainrouter.dev/docs/agent-skill) | Your coding agent follows reusable instructions | MIT source · alpha | [GitHub](https://github.com/AgenticFI/onchain-router-clients) |
| [OpenClaw](https://onchainrouter.dev/docs/openclaw) | You use OpenClaw agents | GitHub alpha · 0.1.0 | [GitHub](https://github.com/AgenticFI/onchain-router-openclaw) |
| [Hermes Agent](https://onchainrouter.dev/docs/hermes) | You use Hermes Agent | GitHub alpha · 0.1.0 | [GitHub](https://github.com/AgenticFI/onchain-router-hermes) |

## Agent-host integrations

- [OpenClaw](https://onchainrouter.dev/docs/openclaw) `0.1.0` is a public MIT alpha installed from its immutable [GitHub release](https://github.com/AgenticFI/onchain-router-openclaw/releases/tag/v0.1.0) with OpenClaw's native Git installer: `openclaw plugins install git:github.com/AgenticFI/onchain-router-openclaw@v0.1.0 --force`. It is not yet listed on ClawHub.
- [Hermes Agent](https://onchainrouter.dev/docs/hermes) `0.1.0` is a public MIT alpha installed from [AgenticFI/onchain-router-hermes](https://github.com/AgenticFI/onchain-router-hermes/releases/tag/v0.1.0) with Hermes' native Git installer: `hermes plugins install AgenticFI/onchain-router-hermes --enable`. It is not a PyPI release, and PyPI is not required for this host-native path.
- The portable [Agent Skill](https://onchainrouter.dev/docs/agent-skill) is public in the client repository and requires the matching Buyer CLI.

Verify the exact organization, repository, version, and release commit before installation. These public-alpha installs do not prove a funded request in either host; complete the human-owned Buyer Runtime setup and acceptance flow separately.

## Browser Workbench

[Open Workbench](https://onchainrouter.dev/workbench/). This build includes the browser UI. A read-only local preview cannot submit paid requests; use only an explicitly enabled deployment for payments.

## Update and verify

Pin the `alpha` tag or exact `0.1.2` version. Review release notes before updating, rerun `onchain-router doctor`, and confirm that the local wallet profile, policy, and receipts remain intact. The [product manifest](https://onchainrouter.dev/products.json) records current publication facts; the live [models](https://onchainrouter.dev/v1/models), [pricing](https://onchainrouter.dev/v1/pricing), and HTTP 402 challenge remain authoritative for service behavior.