mirror of
https://github.com/hanzoai/site.git
synced 2026-11-20 21:21:13 +00:00
82 lines
64 KiB
HTML
82 lines
64 KiB
HTML
<div class="is_View _fd-column _minH-100vh"><main class="is_View _fd-column _pb-c-space-10"><section aria-labelledby="_R_2rav5t75tf6bdb_" class="is_View _ox-_platformweb_clip _pos-relative _width-10037 _ox-hidden _oy-hidden _dsp-flex _fd-column _justify-center _minH-calc100svh-172784627 _mt-calc-1calc62003180138 _pt-calc0pxcalc447866377" data-slot="fold"><div aria-hidden="true" class="is_View _pos-absolute _t-0px _l-0px _r-0px _height-640px _pe-none _backgroundImage-radial-grad1214971095"></div><div class="is_View _fd-column _pos-relative _width-10037 _maxW-1320px _mr-auto _ml-auto _pr-page-gutter _pl-page-gutter _pt-max40pxmin8857263194 _pb-max48pxmin8857263194"><div class="is_View _gridTemplateColumns-_lg_minmax00--92f1930126211 _dsp-grid _gridTemplateColumns-minmax01fr1234957 _items-center _gap-max36pxmin5518920252 _width-10037"><div class="is_View _text-_platformweb_center _items-_lg_flex-start _text-_lg_start _fd-column _minW-0px _gap-c-space-4 _items-center"><div class="is_View _self-_lg_flex-start _self-center"><div class="is_View _btlr-_platformweb_9999px _btrr-_platformweb_9999px _bbrr-_platformweb_9999px _bblr-_platformweb_9999px _dsp-_platformweb_inline-flex _width-_platformweb_fit-content _textDecoration-_platformweb_none _self-flex-start _dsp-inline-flex _fd-row _items-center _justify-center _gap-6px _pr-12px _pl-12px _pt-4px _pb-4px _btlr-9999px _btrr-9999px _bbrr-9999px _bblr-9999px _bg-transparent _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-border-stro3513 _brc-border-stro3513 _borderBottomColor-border-stro3513 _borderLeftColor-border-stro3513 _pos-relative _ox-hidden _oy-hidden _bbs-solid _bts-solid _bls-solid _brs-solid" data-label=""><span class="is_Text font_mono _col-muted-foreg108704142 _ff-f-family _fs-f-size-1 _lh-f-lineHeigh112920 _fw-600" data-slot="text"><span class="is_View _fd-row _items-center _gap-6px"><svg aria-hidden="true" class="lucide lucide-bot" fill="none" height="12" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewbox="0 0 24 24" width="12" xmlns="http://www.w3.org/2000/svg"><path d="M12 8V4H8"></path><rect height="12" rx="2" width="16" x="4" y="8"></rect><path d="M2 14h2"></path><path d="M20 14h2"></path><path d="M15 13v2"></path><path d="M9 13v2"></path></svg><span>For agents</span></span></span></div></div><h1 class="is_Text font_heading _fs-_sm_f-size-11 _fs-_lg_text-6xl _col-foreground _dsp-revert-laye114 _ws-inherit _ff-f-family _fs-f-size-10 _fw-497 _lh-1--19 _ls--0--012em _textWrap-balance _width-10037 _maxW-640px" data-slot="display" id="_R_2rav5t75tf6bdb_">Hanzo for agents: free to start, pay as you go</h1><p class="is_Text _textWrap-_platformweb_balance _col-muted-foreg108704142 _dsp-revert-laye114 _ws-inherit _fs-f-size-4 _lh-1--65 _ls-0px _textWrap-pretty _maxW-600px" data-slot="lede">Sign up free with a wallet. Get an API key free. A small free allowance to try it. Top up in USDC or USDT over the API to raise your limits and pay as you go. No human required.</p><div class="is_View _justify-_lg_flex-start _fd-row _mt-c-space-2 _fwr-wrap _gap-c-space-3 _justify-center"><div class="is_View _fd-row _gap-c-space-3 _fwr-wrap"><a class="is_Text _o-0hover-0--92 _bg-0hover-neutral-100 _col-0hover-pure-black _bg-_light_foreground _col-_light_background _bxsh-_light_04px16px-6p44459065 _bg-_light_0hover-foreground _col-_light_0hover-background _col-pure-black _dsp-inline-flex _items-center _ws-inherit _td-none _fs-f-size-2 _lh-calc1--250--87537940352 _justify-center _gap-c-space-2 _minH-44px _pr-c-space-5 _pl-c-space-5 _btlr-9999px _btrr-9999px _bbrr-9999px _bblr-9999px _fw-500 _backdropFilter-chrome-blur _WebkitBackdropFilter-chrome-blur _btw-0px _brw-0px _borderBottomWidth-0px _borderLeftWidth-0px _bg-pure-white _bxsh-04px20px-2p736498123 _bbs-solid _bts-solid _bls-solid _brs-solid" data-fill="" data-slot="action" href="#headless">Sign up headless<!-- --> <svg aria-hidden="true" class="lucide lucide-terminal" fill="none" height="16" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewbox="0 0 24 24" width="16" xmlns="http://www.w3.org/2000/svg"><path d="M12 19h8"></path><path d="m4 17 6-6-6-6"></path></svg></a><a class="is_View _btc-0hover-rim _brc-0hover-rim _borderBottomColor-0hover-rim _borderLeftColor-0hover-rim _fd-row _self-flex-start _maxW-10037 _minH-44px _items-center _gap-c-space-2 _pr-c-space-4--53 _pl-c-space-4--53 _pt-c-space-2 _pb-c-space-2 _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-edge _brc-edge _borderBottomColor-edge _borderLeftColor-edge _btlr-c-radius-10 _btrr-c-radius-10 _bbrr-c-radius-10 _bblr-c-radius-10 _bbs-solid _bts-solid _bls-solid _brs-solid" href="https://docs.hanzo.ai/docs/agents" rel="noreferrer noopener" target="_blank"><span class="is_Text _col-ink _fs-f-size-3 _fw-500" data-slot="text">Read the docs</span></a></div></div></div><div class="is_View _maxW-_lg_10037 _fd-column _minW-0px _width-10037 _maxW-640px _mr-auto _ml-auto"><div class="is_View _fd-column _width-10037" data-slot="steps"><div class="is_View _btc-0hover-border-stro3513 _brc-0hover-border-stro3513 _borderBottomColor-0hover-border-stro3513 _borderLeftColor-0hover-border-stro3513 _btlr-_platformweb_20px _btrr-_platformweb_20px _bbrr-_platformweb_20px _bblr-_platformweb_20px _fd-_platformweb_column _pos-relative _ox-hidden _oy-hidden _btlr-20px _btrr-20px _bbrr-20px _bblr-20px _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-border _brc-border _borderBottomColor-border _borderLeftColor-border _bg-pure-black _minH-340px _dsp-flex _bbs-solid _bts-solid _bls-solid _brs-solid" data-model="koma" data-tilt=""><div data-film="" data-shape="tall" data-slug="koma"><picture><img alt="" decoding="async" height="1500" loading="lazy" src="/models/koma.webp" width="1200"/></picture></div><div aria-hidden="true" class="is_View" data-scrim=""></div><div class="is_View _pt-_md_28px _pr-_md_28px _pb-_md_28px _pl-_md_28px _fd-column _pos-relative _grow-1 _justify-space-betwe3241 _pt-22px _pr-22px _pb-22px _pl-22px _gap-20px"><div class="is_View _fd-row _items-center _justify-space-betwe3241 _gap-12px"><div class="is_View _btlr-_platformweb_9999px _btrr-_platformweb_9999px _bbrr-_platformweb_9999px _bblr-_platformweb_9999px _col-_platformweb_white-80 _fd-row _items-center _gap-6px _pr-10px _pl-10px _pt-4px _pb-4px _btlr-9999px _btrr-9999px _bbrr-9999px _bblr-9999px _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-white-20 _brc-white-20 _borderBottomColor-white-20 _borderLeftColor-white-20 _bg-rgba0000--5538295333 _bbs-solid _bts-solid _bls-solid _brs-solid"><div aria-hidden="true" class="is_View _dsp-grid _items-center _justify-center"><svg aria-hidden="true" class="lucide lucide-terminal" fill="none" height="12" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewbox="0 0 24 24" width="12" xmlns="http://www.w3.org/2000/svg"><path d="M12 19h8"></path><path d="m4 17 6-6-6-6"></path></svg></div><span class="is_Text font_mono _ls-_platformweb_0--08em _ws-_platformweb_nowrap _col-white-80 _ff-f-family _fs-10px _lh-14px _tt-uppercase" data-slot="text">Headless</span></div><span aria-hidden="true" class="is_Text font_mono _ls-_platformweb_0--08em _col-white-80 _ff-f-family _fs-10px _lh-14px _o-0--6" data-slot="text">01 / 05</span></div><div class="is_View _dsp-grid _items-flex-end _pt-8px _pb-8px"><div aria-hidden="false" class="is_View _gridArea-_platformweb_1132241 _transition-_platformweb_opacity300m1660357531 _fd-column _gap-10px _o-1 _pe-auto"><span aria-hidden="true" class="is_Text _fs-_md_32px _lh-_md_38px _ls-_platformweb_-0--02em _col-pure-white _fs-28px _lh-34px _fw-500 _maxW-min88420px38086424" data-slot="text">Sign up with a wallet</span><p class="is_Text _col-white-80 _mt-0px _mr-0px _mb-0px _ml-0px _fs-f-size-3 _lh-f-lineHeigh112923 _maxW-min82380px38086424" data-slot="text">Sign a one-time challenge from hanzo.id. A first-seen wallet gets its own account and organization.</p></div><div aria-hidden="true" class="is_View _gridArea-_platformweb_1132241 _transition-_platformweb_opacity300m1660357531 _fd-column _gap-10px _o-0 _pe-none"><span aria-hidden="true" class="is_Text _fs-_md_32px _lh-_md_38px _ls-_platformweb_-0--02em _col-pure-white _fs-28px _lh-34px _fw-500 _maxW-min88420px38086424" data-slot="text">Get a key</span><p class="is_Text _col-white-80 _mt-0px _mr-0px _mb-0px _ml-0px _fs-f-size-3 _lh-f-lineHeigh112923 _maxW-min82380px38086424" data-slot="text">POST /v1/account/keys with that token. It is shown once.</p></div><div aria-hidden="true" class="is_View _gridArea-_platformweb_1132241 _transition-_platformweb_opacity300m1660357531 _fd-column _gap-10px _o-0 _pe-none"><span aria-hidden="true" class="is_Text _fs-_md_32px _lh-_md_38px _ls-_platformweb_-0--02em _col-pure-white _fs-28px _lh-34px _fw-500 _maxW-min88420px38086424" data-slot="text">Make a first call</span><p class="is_Text _col-white-80 _mt-0px _mr-0px _mb-0px _ml-0px _fs-f-size-3 _lh-f-lineHeigh112923 _maxW-min82380px38086424" data-slot="text">POST /v1/chat/completions. GET /v1/billing/tier says what the free allowance has left.</p></div><div aria-hidden="true" class="is_View _gridArea-_platformweb_1132241 _transition-_platformweb_opacity300m1660357531 _fd-column _gap-10px _o-0 _pe-none"><span aria-hidden="true" class="is_Text _fs-_md_32px _lh-_md_38px _ls-_platformweb_-0--02em _col-pure-white _fs-28px _lh-34px _fw-500 _maxW-min88420px38086424" data-slot="text">Top up in USDC or USDT</span><p class="is_Text _col-white-80 _mt-0px _mr-0px _mb-0px _ml-0px _fs-f-size-3 _lh-f-lineHeigh112923 _maxW-min82380px38086424" data-slot="text">POST /v1/billing/crypto/deposit returns the address to send to; the balance is credited when the chain confirms.</p></div><div aria-hidden="true" class="is_View _gridArea-_platformweb_1132241 _transition-_platformweb_opacity300m1660357531 _fd-column _gap-10px _o-0 _pe-none"><span aria-hidden="true" class="is_Text _fs-_md_32px _lh-_md_38px _ls-_platformweb_-0--02em _col-pure-white _fs-28px _lh-34px _fw-500 _maxW-min88420px38086424" data-slot="text">Pay as you go</span><p class="is_Text _col-white-80 _mt-0px _mr-0px _mb-0px _ml-0px _fs-f-size-3 _lh-f-lineHeigh112923 _maxW-min82380px38086424" data-slot="text">Each call is billed from your balance at its model’s rate in GET /v1/pricing.</p></div></div><div class="is_View _fd-column _gap-12px"><ol class="is_View _listStyle-_platformweb_none _fd-row _mt-0px _mr-0px _mb-0px _ml-0px _pt-0px _pr-0px _pb-0px _pl-0px _fwr-wrap _gap-6px"><li class="is_View _listStyle-_platformweb_none"><button aria-expanded="true" class="is_View _btc-0hover-pure-white _brc-0hover-pure-white _borderBottomColor-0hover-pure-white _borderLeftColor-0hover-pure-white _outlineWidth-0focus-visible-2px _outlineStyle-0focus-visible-solid _outlineColor-0focus-visible-ring _outlineOffset-0focus-visible-2px _btlr-_platformweb_9999px _btrr-_platformweb_9999px _bbrr-_platformweb_9999px _bblr-_platformweb_9999px _col-_platformweb_pure-black _transition-_platformweb_background-1587323852 _fd-row _items-center _gap-6px _pr-11px _pl-11px _pt-5px _pb-5px _btlr-9999px _btrr-9999px _bbrr-9999px _bblr-9999px _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-pure-white _brc-pure-white _borderBottomColor-pure-white _borderLeftColor-pure-white _bg-pure-white _cur-pointer _bbs-solid _bts-solid _bls-solid _brs-solid"><span class="is_Text font_mono _ls-_platformweb_0--06em _ws-_platformweb_nowrap _col-inherit _ff-f-family _fs-10px _lh-14px _fw-600 _tt-uppercase" data-slot="text">Sign up with a wallet</span></button></li><li class="is_View _listStyle-_platformweb_none"><button aria-expanded="false" class="is_View _btc-0hover-pure-white _brc-0hover-pure-white _borderBottomColor-0hover-pure-white _borderLeftColor-0hover-pure-white _outlineWidth-0focus-visible-2px _outlineStyle-0focus-visible-solid _outlineColor-0focus-visible-ring _outlineOffset-0focus-visible-2px _btlr-_platformweb_9999px _btrr-_platformweb_9999px _bbrr-_platformweb_9999px _bblr-_platformweb_9999px _col-_platformweb_white-80 _transition-_platformweb_background-1587323852 _fd-row _items-center _gap-6px _pr-11px _pl-11px _pt-5px _pb-5px _btlr-9999px _btrr-9999px _bbrr-9999px _bblr-9999px _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-white-20 _brc-white-20 _borderBottomColor-white-20 _borderLeftColor-white-20 _bg-rgba0000--6538295333 _cur-pointer _bbs-solid _bts-solid _bls-solid _brs-solid"><span class="is_Text font_mono _ls-_platformweb_0--06em _ws-_platformweb_nowrap _col-inherit _ff-f-family _fs-10px _lh-14px _fw-400 _tt-uppercase" data-slot="text">Get a key</span></button></li><li class="is_View _listStyle-_platformweb_none"><button aria-expanded="false" class="is_View _btc-0hover-pure-white _brc-0hover-pure-white _borderBottomColor-0hover-pure-white _borderLeftColor-0hover-pure-white _outlineWidth-0focus-visible-2px _outlineStyle-0focus-visible-solid _outlineColor-0focus-visible-ring _outlineOffset-0focus-visible-2px _btlr-_platformweb_9999px _btrr-_platformweb_9999px _bbrr-_platformweb_9999px _bblr-_platformweb_9999px _col-_platformweb_white-80 _transition-_platformweb_background-1587323852 _fd-row _items-center _gap-6px _pr-11px _pl-11px _pt-5px _pb-5px _btlr-9999px _btrr-9999px _bbrr-9999px _bblr-9999px _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-white-20 _brc-white-20 _borderBottomColor-white-20 _borderLeftColor-white-20 _bg-rgba0000--6538295333 _cur-pointer _bbs-solid _bts-solid _bls-solid _brs-solid"><span class="is_Text font_mono _ls-_platformweb_0--06em _ws-_platformweb_nowrap _col-inherit _ff-f-family _fs-10px _lh-14px _fw-400 _tt-uppercase" data-slot="text">Make a first call</span></button></li><li class="is_View _listStyle-_platformweb_none"><button aria-expanded="false" class="is_View _btc-0hover-pure-white _brc-0hover-pure-white _borderBottomColor-0hover-pure-white _borderLeftColor-0hover-pure-white _outlineWidth-0focus-visible-2px _outlineStyle-0focus-visible-solid _outlineColor-0focus-visible-ring _outlineOffset-0focus-visible-2px _btlr-_platformweb_9999px _btrr-_platformweb_9999px _bbrr-_platformweb_9999px _bblr-_platformweb_9999px _col-_platformweb_white-80 _transition-_platformweb_background-1587323852 _fd-row _items-center _gap-6px _pr-11px _pl-11px _pt-5px _pb-5px _btlr-9999px _btrr-9999px _bbrr-9999px _bblr-9999px _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-white-20 _brc-white-20 _borderBottomColor-white-20 _borderLeftColor-white-20 _bg-rgba0000--6538295333 _cur-pointer _bbs-solid _bts-solid _bls-solid _brs-solid"><span class="is_Text font_mono _ls-_platformweb_0--06em _ws-_platformweb_nowrap _col-inherit _ff-f-family _fs-10px _lh-14px _fw-400 _tt-uppercase" data-slot="text">Top up in USDC or USDT</span></button></li><li class="is_View _listStyle-_platformweb_none"><button aria-expanded="false" class="is_View _btc-0hover-pure-white _brc-0hover-pure-white _borderBottomColor-0hover-pure-white _borderLeftColor-0hover-pure-white _outlineWidth-0focus-visible-2px _outlineStyle-0focus-visible-solid _outlineColor-0focus-visible-ring _outlineOffset-0focus-visible-2px _btlr-_platformweb_9999px _btrr-_platformweb_9999px _bbrr-_platformweb_9999px _bblr-_platformweb_9999px _col-_platformweb_white-80 _transition-_platformweb_background-1587323852 _fd-row _items-center _gap-6px _pr-11px _pl-11px _pt-5px _pb-5px _btlr-9999px _btrr-9999px _bbrr-9999px _bblr-9999px _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-white-20 _brc-white-20 _borderBottomColor-white-20 _borderLeftColor-white-20 _bg-rgba0000--6538295333 _cur-pointer _bbs-solid _bts-solid _bls-solid _brs-solid"><span class="is_Text font_mono _ls-_platformweb_0--06em _ws-_platformweb_nowrap _col-inherit _ff-f-family _fs-10px _lh-14px _fw-400 _tt-uppercase" data-slot="text">Pay as you go</span></button></li></ol></div></div></div></div></div></div></div></section><div class="is_View _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto" id="install"><section class="is_View _fd-column _pt-c-space-7 _pb-c-space-7 _pr-maxvar--pag1616741076 _pl-maxvar--pag1616741076"><div class="is_View _fd-column _width-10037"><h2 class="is_Text _col-ink _mb-c-space-2 _fs-f-size-7 _fw-500 _ls-f-letterSpa1360334199" data-slot="text">One command installs the whole stack</h2><p class="is_Text _col-soft _mb-c-space-5 _maxW-672px _fs-f-size-3" data-slot="text">The CLI, the coding agent, the MCP server and the inference engine are native Rust binaries. npm installs a small launcher; each binary downloads, checksum-verified, the first time it runs. Any OS, Windows included.</p><div class="is_View _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto _ox-hidden _oy-hidden _btlr-radius-2xl _btrr-radius-2xl _bbrr-radius-2xl _bblr-radius-2xl _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-border _brc-border _borderBottomColor-border _borderLeftColor-border _bg-card _bbs-solid _bts-solid _bls-solid _brs-solid"><div class="is_View _fd-row _borderBottomWidth-1px _btc-border _brc-border _borderBottomColor-border _borderLeftColor-border _bg-muted _pr-16px _pl-16px _pt-8px _pb-8px _items-center _gap-12px _bbs-solid"><span class="is_Text font_mono _col-text-second96872 _ff-f-family _fs-f-size-1" data-slot="text">Install</span><div class="is_View _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto _ml-auto"><button aria-label="Copy the install command" class="is_View _o-0hover-1 _bg-0hover-hover _o-0focus-1 _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto _btw-0px _brw-0px _borderBottomWidth-0px _borderLeftWidth-0px _bg-transparent _pt-c-space-1 _pr-c-space-1 _pb-c-space-1 _pl-c-space-1 _btlr-c-radius-2 _btrr-c-radius-2 _bbrr-c-radius-2 _bblr-c-radius-2 _o-1 _bbs-solid _bts-solid _bls-solid _brs-solid"><div class="is_View _fd-row _items-center _gap-c-space-1"><svg aria-hidden="true" class="lucide lucide-copy" fill="none" height="13" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewbox="0 0 24 24" width="13" xmlns="http://www.w3.org/2000/svg"><rect height="14" rx="2" ry="2" width="14" x="8" y="8"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg><span class="is_Text _col-ink _fs-f-size-2" data-slot="text">Copy</span></div></button></div></div><pre class="is_Text font_mono _col-text-second96872 _fs-f-size-2 _lh-leading-rel3008278 _dsp-block _mt-0px _mr-0px _mb-0px _ml-0px _pt-20px _pr-20px _pb-20px _pl-20px _ff-f-family _ws-pre-wrap" data-slot="text">npm i -g hanzo # any OS; or: curl -fsSL https://hanzo.sh | sh
|
||
hanzo auth login # a person approves once; headless agents use a key
|
||
hanzo # a coding session in this repo (fetches the agent)
|
||
hanzo mcp # the MCP server over stdio (fetched on first run)
|
||
hanzo engine serve <model> # local inference (fetched on first run)
|
||
|
||
# Register the MCP server with nothing installed first:
|
||
claude mcp add --scope user hanzo -- npx -y hanzo mcp</pre></div></div></section></div><div class="is_View _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto" id="headless"><section class="is_View _fd-column _pt-c-space-7 _pb-c-space-7 _pr-maxvar--pag1616741076 _pl-maxvar--pag1616741076"><div class="is_View _fd-column _width-10037"><h2 class="is_Text _col-ink _mb-c-space-2 _fs-f-size-7 _fw-500 _ls-f-letterSpa1360334199" data-slot="text">The five steps, as one script</h2><p class="is_Text _col-soft _mb-c-space-5 _maxW-672px _fs-f-size-3" data-slot="text">Every step is one request. This file makes them all, as it was run against production.</p><div class="is_View _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto _btlr-radius-md _btrr-radius-md _bbrr-radius-md _bblr-radius-md _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-border _brc-border _borderBottomColor-border _borderLeftColor-border _ox-hidden _oy-hidden _bbs-solid _bts-solid _bls-solid _brs-solid"><pre class="is_Text font_mono _bg-_platformweb_light-darkv602359144 _col-codeInk _fs-f-size-2 _lh-leading-rel3008278 _dsp-block _mt-0px _mr-0px _mb-0px _ml-0px _pt-16px _pr-16px _pb-16px _pl-16px _ox-auto _ws-pre _ff-f-family" data-slot="text"><code><span><span data-code="comment" data-face="italic">// No human required: sign up with a wallet, get a key, call the API, top up in USDC or USDT.</span>
|
||
</span><span><span data-code="comment" data-face="italic">// A first-seen wallet gets its own Hanzo account and organization, with a small free allowance to try it.</span>
|
||
</span><span><span data-code="comment" data-face="italic">// npm i @hanzo/ai viem · node agent.ts (Node 22.18+; set HANZO_WALLET_KEY to use your own wallet)</span>
|
||
</span><span><span data-code="keyword" data-face="bold">import</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> Hanzo </span><span data-code="punctuation">}</span><span data-code="ink"> </span><span data-code="keyword" data-face="bold">from</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">@hanzo/ai</span><span data-code="punctuation">'</span>
|
||
</span><span><span data-code="keyword" data-face="bold">import</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> generatePrivateKey</span><span data-code="punctuation">,</span><span data-code="ink"> privateKeyToAccount </span><span data-code="punctuation">}</span><span data-code="ink"> </span><span data-code="keyword" data-face="bold">from</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">viem/accounts</span><span data-code="punctuation">'</span>
|
||
</span><span><span data-code="keyword" data-face="bold">import</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> createHash</span><span data-code="punctuation">,</span><span data-code="ink"> randomBytes </span><span data-code="punctuation">}</span><span data-code="ink"> </span><span data-code="keyword" data-face="bold">from</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">node:crypto</span><span data-code="punctuation">'</span>
|
||
</span><span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> ID = </span><span data-code="punctuation">'</span><span data-code="string">https://hanzo.id</span><span data-code="punctuation">'</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> API = </span><span data-code="punctuation">'</span><span data-code="string">https://api.hanzo.ai</span><span data-code="punctuation">'</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> CLIENT = </span><span data-code="punctuation">'</span><span data-code="string">hanzo-ai</span><span data-code="punctuation">'</span>
|
||
</span><span>
|
||
</span><span><span data-code="comment" data-face="italic">// Your agent's own wallet, or a fresh one. The key never leaves this process.</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> account = </span><span data-code="bright">privateKeyToAccount</span><span data-code="punctuation">((</span><span data-code="ink">process.env.HANZO_WALLET_KEY </span><span data-code="keyword" data-face="bold">as</span><span data-code="ink"> </span><span data-code="punctuation">`</span><span data-code="string">0x</span><span data-code="punctuation">${</span><span data-code="string">string</span><span data-code="punctuation">}`</span><span data-code="punctuation">)</span><span data-code="ink"> ?? </span><span data-code="bright">generatePrivateKey</span><span data-code="punctuation">())</span>
|
||
</span><span>
|
||
</span><span><span data-code="comment" data-face="italic">// 1. Sign up with a wallet: get a challenge, sign it, verify (POST /v1/iam/web3/verify), exchange for a token.</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> nonce = </span><span data-code="keyword" data-face="bold">await</span><span data-code="ink"> </span><span data-code="bright">fetch</span><span data-code="punctuation">(</span><span data-code="punctuation">`${</span><span data-code="string">ID</span><span data-code="punctuation">}</span><span data-code="string">/v1/iam/web3/nonce?chain=evm&address=</span><span data-code="punctuation">${</span><span data-code="string">account</span><span data-code="ink">.</span><span data-code="string">address</span><span data-code="punctuation">}`</span><span data-code="punctuation">)</span><span data-code="ink">.</span><span data-code="bright">then</span><span data-code="punctuation">((</span><span data-code="ink">r</span><span data-code="punctuation">)</span><span data-code="ink"> </span><span data-code="keyword" data-face="bold">=></span><span data-code="ink"> r.</span><span data-code="bright">json</span><span data-code="punctuation">())</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> message = </span><span data-code="punctuation">[</span><span data-code="punctuation">`${</span><span data-code="string">nonce</span><span data-code="ink">.</span><span data-code="string">data</span><span data-code="ink">.</span><span data-code="string">domain</span><span data-code="punctuation">}</span><span data-code="string"> wants you to sign in with your Ethereum account:</span><span data-code="punctuation">`</span><span data-code="punctuation">,</span><span data-code="ink"> account.address</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">''</span><span data-code="punctuation">,</span><span data-code="ink"> ...</span><span data-code="punctuation">(</span><span data-code="ink">nonce.data.statement ? </span><span data-code="punctuation">[</span><span data-code="ink">nonce.data.statement</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">''</span><span data-code="punctuation">]</span><span data-code="ink"> : </span><span data-code="punctuation">[]),</span><span data-code="ink"> </span><span data-code="punctuation">`</span><span data-code="string">URI: </span><span data-code="punctuation">${</span><span data-code="string">nonce</span><span data-code="ink">.</span><span data-code="string">data</span><span data-code="ink">.</span><span data-code="string">uri</span><span data-code="punctuation">}`</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">`</span><span data-code="string">Version: </span><span data-code="punctuation">${</span><span data-code="string">nonce</span><span data-code="ink">.</span><span data-code="string">data</span><span data-code="ink">.</span><span data-code="string">version</span><span data-code="punctuation">}`</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">`</span><span data-code="string">Nonce: </span><span data-code="punctuation">${</span><span data-code="string">nonce</span><span data-code="ink">.</span><span data-code="string">data</span><span data-code="ink">.</span><span data-code="string">nonce</span><span data-code="punctuation">}`</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">`</span><span data-code="string">Issued At: </span><span data-code="punctuation">${</span><span data-code="string">nonce</span><span data-code="ink">.</span><span data-code="string">data</span><span data-code="ink">.</span><span data-code="string">issuedAt</span><span data-code="punctuation">}`</span><span data-code="punctuation">]</span><span data-code="ink">.</span><span data-code="bright">join</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="bright">\n</span><span data-code="punctuation">'</span><span data-code="punctuation">)</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> signature = </span><span data-code="keyword" data-face="bold">await</span><span data-code="ink"> account.</span><span data-code="bright">signMessage</span><span data-code="punctuation">({</span><span data-code="ink"> message </span><span data-code="punctuation">})</span>
|
||
</span><span>
|
||
</span><span><span data-code="comment" data-face="italic">// Verify the signed challenge: a first-seen wallet gets an account and an organization of its own.</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> verifier = </span><span data-code="bright">randomBytes</span><span data-code="punctuation">(</span><span data-code="number">32</span><span data-code="punctuation">)</span><span data-code="ink">.</span><span data-code="bright">toString</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="string">base64url</span><span data-code="punctuation">'</span><span data-code="punctuation">)</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> challenge = </span><span data-code="bright">createHash</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="string">sha256</span><span data-code="punctuation">'</span><span data-code="punctuation">)</span><span data-code="ink">.</span><span data-code="bright">update</span><span data-code="punctuation">(</span><span data-code="ink">verifier</span><span data-code="punctuation">)</span><span data-code="ink">.</span><span data-code="bright">digest</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="string">base64url</span><span data-code="punctuation">'</span><span data-code="punctuation">)</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> data</span><span data-code="punctuation">:</span><span data-code="ink"> code </span><span data-code="punctuation">}</span><span data-code="ink"> = </span><span data-code="keyword" data-face="bold">await</span><span data-code="ink"> </span><span data-code="bright">fetch</span><span data-code="punctuation">(</span><span data-code="punctuation">`${</span><span data-code="string">ID</span><span data-code="punctuation">}</span><span data-code="string">/v1/iam/web3/verify</span><span data-code="punctuation">`</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">{</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">method</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">POST</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">headers</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">Content-Type</span><span data-code="punctuation">'</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">application/json</span><span data-code="punctuation">'</span><span data-code="ink"> </span><span data-code="punctuation">},</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">body</span><span data-code="punctuation">:</span><span data-code="ink"> JSON.</span><span data-code="bright">stringify</span><span data-code="punctuation">({</span><span data-code="ink"> </span><span data-code="key">clientId</span><span data-code="punctuation">:</span><span data-code="ink"> CLIENT</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">chain</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">evm</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">scheme</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">secp256k1-eip191</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">address</span><span data-code="punctuation">:</span><span data-code="ink"> account.address</span><span data-code="punctuation">,</span><span data-code="ink"> message</span><span data-code="punctuation">,</span><span data-code="ink"> signature</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">type</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">code</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">redirectUri</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">http://localhost:3000/callback</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">scope</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">openid profile email</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">codeChallenge</span><span data-code="punctuation">:</span><span data-code="ink"> challenge</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">codeChallengeMethod</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">S256</span><span data-code="punctuation">'</span><span data-code="ink"> </span><span data-code="punctuation">}),</span>
|
||
</span><span><span data-code="punctuation">})</span><span data-code="ink">.</span><span data-code="bright">then</span><span data-code="punctuation">((</span><span data-code="ink">r</span><span data-code="punctuation">)</span><span data-code="ink"> </span><span data-code="keyword" data-face="bold">=></span><span data-code="ink"> r.</span><span data-code="bright">json</span><span data-code="punctuation">())</span>
|
||
</span><span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> token = </span><span data-code="keyword" data-face="bold">await</span><span data-code="ink"> </span><span data-code="bright">fetch</span><span data-code="punctuation">(</span><span data-code="punctuation">`${</span><span data-code="string">ID</span><span data-code="punctuation">}</span><span data-code="string">/v1/iam/oauth/token</span><span data-code="punctuation">`</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">{</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">method</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">POST</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">headers</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">Content-Type</span><span data-code="punctuation">'</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">application/x-www-form-urlencoded</span><span data-code="punctuation">'</span><span data-code="ink"> </span><span data-code="punctuation">},</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">body</span><span data-code="punctuation">:</span><span data-code="ink"> new </span><span data-code="bright">URLSearchParams</span><span data-code="punctuation">({</span><span data-code="ink"> </span><span data-code="key">grant_type</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">authorization_code</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">client_id</span><span data-code="punctuation">:</span><span data-code="ink"> CLIENT</span><span data-code="punctuation">,</span><span data-code="ink"> code</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">code_verifier</span><span data-code="punctuation">:</span><span data-code="ink"> verifier</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">redirect_uri</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">http://localhost:3000/callback</span><span data-code="punctuation">'</span><span data-code="ink"> </span><span data-code="punctuation">}),</span>
|
||
</span><span><span data-code="punctuation">})</span><span data-code="ink">.</span><span data-code="bright">then</span><span data-code="punctuation">((</span><span data-code="ink">r</span><span data-code="punctuation">)</span><span data-code="ink"> </span><span data-code="keyword" data-face="bold">=></span><span data-code="ink"> r.</span><span data-code="bright">json</span><span data-code="punctuation">())</span>
|
||
</span><span>
|
||
</span><span><span data-code="comment" data-face="italic">// 2. Get an API key (POST /v1/account/keys) that outlives the token. Shown once.</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> hanzo = new </span><span data-code="bright">Hanzo</span><span data-code="punctuation">({</span><span data-code="ink"> </span><span data-code="key">apiKey</span><span data-code="punctuation">:</span><span data-code="ink"> token.access_token</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">baseURL</span><span data-code="punctuation">:</span><span data-code="ink"> API </span><span data-code="punctuation">})</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> key </span><span data-code="punctuation">}</span><span data-code="ink"> = </span><span data-code="keyword" data-face="bold">await</span><span data-code="ink"> hanzo.account.keys.</span><span data-code="bright">create</span><span data-code="punctuation">({</span><span data-code="ink"> </span><span data-code="key">name</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">agent</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">type</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">secret</span><span data-code="punctuation">'</span><span data-code="ink"> </span><span data-code="punctuation">})</span>
|
||
</span><span>
|
||
</span><span><span data-code="comment" data-face="italic">// 3. Use AI (POST /v1/chat/completions) with the Hanzo SDK — OpenAI-compatible, one line.</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> client = new </span><span data-code="bright">Hanzo</span><span data-code="punctuation">({</span><span data-code="ink"> </span><span data-code="key">apiKey</span><span data-code="punctuation">:</span><span data-code="ink"> key</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">baseURL</span><span data-code="punctuation">:</span><span data-code="ink"> API </span><span data-code="punctuation">})</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> chat = </span><span data-code="keyword" data-face="bold">await</span><span data-code="ink"> client.chat.completions.</span><span data-code="bright">create</span><span data-code="punctuation">({</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">model</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">zen-free</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">messages</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">[{</span><span data-code="ink"> </span><span data-code="key">role</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">user</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">content</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">Reply with the single word: ready</span><span data-code="punctuation">'</span><span data-code="ink"> </span><span data-code="punctuation">}],</span>
|
||
</span><span><span data-code="punctuation">})</span>
|
||
</span><span><span data-code="ink">console.</span><span data-code="bright">log</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="string">chat</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> chat.choices</span><span data-code="punctuation">[</span><span data-code="number">0</span><span data-code="punctuation">]</span><span data-code="ink">?.message?.content</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">free left today:</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> chat.headers?.</span><span data-code="bright">get</span><span data-code="ink">?.</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="string">x-ratelimit-remaining</span><span data-code="punctuation">'</span><span data-code="punctuation">))</span>
|
||
</span><span>
|
||
</span><span><span data-code="comment" data-face="italic">// Or make a Kai decision — typed, calibrated, zero output tokens.</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> decision = </span><span data-code="keyword" data-face="bold">await</span><span data-code="ink"> client.decisions.</span><span data-code="bright">create</span><span data-code="punctuation">({</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">model</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">kai</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">state</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> </span><span data-code="key">ticket</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">The export button throws a 500 error since this morning.</span><span data-code="punctuation">'</span><span data-code="ink"> </span><span data-code="punctuation">},</span>
|
||
</span><span><span data-code="ink"> </span><span data-code="key">questions</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> </span><span data-code="key">team</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> </span><span data-code="key">type</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">choice</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">instructions</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">Which team should handle this ticket?</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">criteria</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">{</span><span data-code="ink"> </span><span data-code="key">billing</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">charges, invoices, refunds</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">tech</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">bugs, errors, outages</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">other</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">anything else</span><span data-code="punctuation">'</span><span data-code="ink"> </span><span data-code="punctuation">}</span><span data-code="ink"> </span><span data-code="punctuation">}</span><span data-code="ink"> </span><span data-code="punctuation">},</span>
|
||
</span><span><span data-code="punctuation">})</span>
|
||
</span><span><span data-code="ink">console.</span><span data-code="bright">log</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="string">decision</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> decision.answers</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">input tokens:</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> decision.usage.input_tokens</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">latency:</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> decision.latency_ms + </span><span data-code="punctuation">'</span><span data-code="string">ms</span><span data-code="punctuation">'</span><span data-code="punctuation">)</span>
|
||
</span><span>
|
||
</span><span><span data-code="comment" data-face="italic">// 4. Top up in USDC or Card (POST /v1/billing/crypto/deposit · GET /v1/billing/crypto/options · GET /v1/billing/tier).</span>
|
||
</span><span><span data-code="keyword" data-face="bold">const</span><span data-code="ink"> deposit = </span><span data-code="keyword" data-face="bold">await</span><span data-code="ink"> client.billing.crypto.</span><span data-code="bright">deposit</span><span data-code="punctuation">({</span><span data-code="ink"> </span><span data-code="key">chain</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">base</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">token</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">usdc</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="key">amountCents</span><span data-code="punctuation">:</span><span data-code="ink"> </span><span data-code="number">500</span><span data-code="ink"> </span><span data-code="punctuation">})</span>
|
||
</span><span><span data-code="ink">console.</span><span data-code="bright">log</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="string">send to</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> deposit.depositAddress</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">'</span><span data-code="string">then poll</span><span data-code="punctuation">'</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="punctuation">`${</span><span data-code="string">API</span><span data-code="punctuation">}</span><span data-code="string">/v1/billing/crypto/deposit/</span><span data-code="punctuation">${</span><span data-code="string">deposit</span><span data-code="ink">.</span><span data-code="string">id</span><span data-code="punctuation">}`</span><span data-code="punctuation">)</span>
|
||
</span><span>
|
||
</span><span><span data-code="ink">console.</span><span data-code="bright">log</span><span data-code="punctuation">(</span><span data-code="punctuation">'</span><span data-code="string">HANZO_API_KEY=</span><span data-code="punctuation">'</span><span data-code="ink"> + key.</span><span data-code="bright">slice</span><span data-code="punctuation">(</span><span data-code="number">0</span><span data-code="punctuation">,</span><span data-code="ink"> </span><span data-code="number">12</span><span data-code="punctuation">)</span><span data-code="ink"> + </span><span data-code="punctuation">'</span><span data-code="string">… (store the whole key; it is shown once)</span><span data-code="punctuation">'</span><span data-code="punctuation">)</span></span></code></pre></div><p class="is_Text _col-soft _mt-c-space-4 _fs-f-size-3 _maxW-720px" data-slot="text">Keep the wallet key and the API key in your secret store: the wallet is the account, and the API key is shown once. A deposit address lasts 24 hours and is credited when the chain confirms; send only the token and chain it names.</p></div></section></div><section class="is_View _fd-column _pt-c-space-7 _pb-c-space-7 _pr-maxvar--pag1616741076 _pl-maxvar--pag1616741076"><div class="is_View _fd-column _width-10037"><h2 class="is_Text _col-ink _mb-c-space-2 _fs-f-size-7 _fw-500 _ls-f-letterSpa1360334199" data-slot="text">Paste this into your agent</h2><p class="is_Text _col-soft _mb-c-space-5 _maxW-672px _fs-f-size-3" data-slot="text">What Hanzo is, the base URL, how to discover the API and the headless path, in one block an agent keeps in its context.</p><div class="is_View _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto _ox-hidden _oy-hidden _btlr-radius-2xl _btrr-radius-2xl _bbrr-radius-2xl _bblr-radius-2xl _btw-1px _brw-1px _borderBottomWidth-1px _borderLeftWidth-1px _btc-border _brc-border _borderBottomColor-border _borderLeftColor-border _bg-card _bbs-solid _bts-solid _bls-solid _brs-solid"><div class="is_View _fd-row _borderBottomWidth-1px _btc-border _brc-border _borderBottomColor-border _borderLeftColor-border _bg-muted _pr-16px _pl-16px _pt-8px _pb-8px _items-center _gap-12px _bbs-solid"><span class="is_Text font_mono _col-text-second96872 _ff-f-family _fs-f-size-1" data-slot="text">Agent prompt</span><div class="is_View _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto _ml-auto"><button aria-label="Copy the agent prompt" class="is_View _o-0hover-1 _bg-0hover-hover _o-0focus-1 _fd-column _dsp-block _shrink-1 _minH-auto _minW-auto _btw-0px _brw-0px _borderBottomWidth-0px _borderLeftWidth-0px _bg-transparent _pt-c-space-1 _pr-c-space-1 _pb-c-space-1 _pl-c-space-1 _btlr-c-radius-2 _btrr-c-radius-2 _bbrr-c-radius-2 _bblr-c-radius-2 _o-1 _bbs-solid _bts-solid _bls-solid _brs-solid"><div class="is_View _fd-row _items-center _gap-c-space-1"><svg aria-hidden="true" class="lucide lucide-copy" fill="none" height="13" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewbox="0 0 24 24" width="13" xmlns="http://www.w3.org/2000/svg"><rect height="14" rx="2" ry="2" width="14" x="8" y="8"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg><span class="is_Text _col-ink _fs-f-size-2" data-slot="text">Copy</span></div></button></div></div><pre class="is_Text font_mono _overflowWrap-_platformweb_anywhere _col-text-second96872 _fs-f-size-2 _lh-leading-rel3008278 _dsp-block _mt-0px _mr-0px _mb-0px _ml-0px _pt-20px _pr-20px _pb-20px _pl-20px _ff-f-family _ws-pre-wrap" data-slot="text">Hanzo (https://hanzo.ai) is the AI operating system for business: one API for every model, Kai decisions and agents, with one key. Building business software since 2014. Techstars '17.
|
||
|
||
Sign up free with a wallet. Get an API key free. A small free allowance to try it. Top up in USDC or USDT over the API to raise your limits and pay as you go. No human required.
|
||
|
||
Base URL: https://api.hanzo.ai/v1 (chat completions in the OpenAI shape). Discover: GET https://api.hanzo.ai/v1 lists every capability, GET https://api.hanzo.ai/v1/<capability> its operations, and https://api.hanzo.ai/v1/openapi.json is the whole spec. No key needed for any of the three.
|
||
|
||
1. Sign up with a wallet: GET https://hanzo.id/v1/iam/web3/nonce?chain=evm&address=<address>, sign the CAIP-122 message it describes with EIP-191 personal_sign, POST https://hanzo.id/v1/iam/web3/verify (clientId "hanzo-ai", chain "evm", scheme "secp256k1-eip191", type "code" with a PKCE challenge), then exchange the code at https://hanzo.id/v1/iam/oauth/token. A first-seen wallet gets its own account and organization. A Solana wallet asks with chain=solana, writes "Solana account" in the message, and sends chain "solana", scheme "ed25519" and its signature as base64, never base58.
|
||
2. Get a key: POST https://api.hanzo.ai/v1/account/keys {"name":"agent","type":"secret"} with that token. The key is shown once.
|
||
3. Read your allowance: GET https://api.hanzo.ai/v1/billing/tier with the key says your plan, what it allows and what is left; GET https://api.hanzo.ai/v1/billing/plans lists every plan and price.
|
||
4. Top up: GET https://api.hanzo.ai/v1/billing/crypto/options, then POST https://api.hanzo.ai/v1/billing/crypto/deposit {"chain":"base","token":"usdc","amountCents":2000}. Send that token on that chain to the address it returns, and GET https://api.hanzo.ai/v1/billing/crypto/deposit/<id> until it says succeeded.
|
||
5. Call: POST https://api.hanzo.ai/v1/chat/completions {"model":"zen-free","messages":[{"role":"user","content":"Hello"}]} with Authorization: Bearer <key>.
|
||
|
||
The whole path as one TypeScript file: https://hanzo.ai/agents#headless. Every request spelled out: https://docs.hanzo.ai/docs/agents. Talk to people at Hanzo: https://cal.com/hanzo.
|
||
|
||
Tools: `npm i -g hanzo` installs the whole native stack on any OS: `hanzo` (the CLI), `hanzo dev` (the coding agent), `hanzo mcp` (the MCP server over stdio) and `hanzo engine serve <model>` (local inference), each binary fetched on first use. To give yourself the MCP tools without installing anything: `npx -y hanzo mcp`.
|
||
|
||
Skills index: https://hanzoskills.com/llms.txt (install with `npx skills add https://hanzoskills.com/hanzo.md`). Hanzo Improvement Proposals: https://hips.hanzo.ai/llms.txt.</pre></div><div class="is_View _fd-row _mt-c-space-5 _fwr-wrap _justify-center _columnGap-c-space-5 _rowGap-c-space-2"><a class="is_Text _col-0hover-pure-white _col-_light_muted-foreg108704142 _col-_light_0hover-foreground _col-neutral-300 _dsp-inline-flex _items-center _ws-inherit _td-none _fs-f-size-2 _lh-calc1--250--87537940352 _gap-c-space-2 _fw-500" data-slot="more" href="/agents/sdk">Agents SDK</a><a class="is_Text _col-0hover-pure-white _col-_light_muted-foreg108704142 _col-_light_0hover-foreground _col-neutral-300 _dsp-inline-flex _items-center _ws-inherit _td-none _fs-f-size-2 _lh-calc1--250--87537940352 _gap-c-space-2 _fw-500" data-slot="more" href="/llms.txt">llms.txt</a><a class="is_Text _col-0hover-pure-white _col-_light_muted-foreg108704142 _col-_light_0hover-foreground _col-neutral-300 _dsp-inline-flex _items-center _ws-inherit _td-none _fs-f-size-2 _lh-calc1--250--87537940352 _gap-c-space-2 _fw-500" data-slot="more" href="https://cal.com/hanzo">Book a call</a></div></div></section><section class="is_View _fd-column _pt-c-space-7 _pb-c-space-7 _pr-maxvar--pag1616741076 _pl-maxvar--pag1616741076"><div class="is_View _fd-column _width-10037"><section class="is_View _fd-column _width-10037 _maxW-680px _mr-auto _ml-auto _gap-c-space-6 _pr-c-space-6 _pl-c-space-6" data-slot="faq"><h2 class="is_Text _fs-_md_f-size-11 _lh-_md_f-lineHeigh3500569 _col-ink _fs-f-size-9 _lh-f-lineHeigh112928 _fw-500 _text-center" data-slot="text" style="letter-spacing:-0.012em;text-wrap:balance">Questions</h2><div class="is_View _fd-column _btw-1px _btc-edge _brc-edge _borderBottomColor-edge _borderLeftColor-edge _bts-solid"><details class="is_View _fd-column _borderBottomWidth-1px _btc-edge _brc-edge _borderBottomColor-edge _borderLeftColor-edge _bbs-solid" data-slot="disclosure"><summary class="is_View _bg-0hover-panel _fd-row _dsp-flex _items-center _justify-space-betwe3241 _gap-c-space-4 _minH-44px _pt-c-space-4 _pb-c-space-4 _cur-pointer" data-slot="disclosure-summary"><span class="is_Text _col-ink _grow-1 _shrink-1 _fb-0px _fs-f-size-5 _fw-497" data-slot="text">What is free?</span><div aria-hidden="true" class="is_View _fd-row _shrink-0" data-slot="disclosure-icon"><svg fill="none" height="16" stroke="var(--quiet)" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" style="color:var(--quiet)" viewbox="0 0 24 24" width="16"><path d="M5 12h14" stroke="var(--quiet)"></path><path d="M12 5v14" stroke="var(--quiet)"></path></svg></div></summary><div class="is_View _fd-column _pb-c-space-5" data-slot="disclosure-content"><div class="is_Text _col-soft _lh-f-lineHeigh112924" data-slot="text">Signing up, the API key and a small free allowance to try it. GET /v1/billing/tier, with your key, says what your account allows and what is left, and every answer carries X-RateLimit-Remaining. A person on the Free plan gets free model requests and Kai decisions; the request after the allowance answers 429 until its window resets.</div></div></details><details class="is_View _fd-column _borderBottomWidth-1px _btc-edge _brc-edge _borderBottomColor-edge _borderLeftColor-edge _bbs-solid" data-slot="disclosure"><summary class="is_View _bg-0hover-panel _fd-row _dsp-flex _items-center _justify-space-betwe3241 _gap-c-space-4 _minH-44px _pt-c-space-4 _pb-c-space-4 _cur-pointer" data-slot="disclosure-summary"><span class="is_Text _col-ink _grow-1 _shrink-1 _fb-0px _fs-f-size-5 _fw-497" data-slot="text">What does it cost after that?</span><div aria-hidden="true" class="is_View _fd-row _shrink-0" data-slot="disclosure-icon"><svg fill="none" height="16" stroke="var(--quiet)" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" style="color:var(--quiet)" viewbox="0 0 24 24" width="16"><path d="M5 12h14" stroke="var(--quiet)"></path><path d="M12 5v14" stroke="var(--quiet)"></path></svg></div></summary><div class="is_View _fd-column _pb-c-space-5" data-slot="disclosure-content"><div class="is_Text _col-soft _lh-f-lineHeigh112924" data-slot="text">You pay as you go from the balance you top up: each call is billed at its model’s rate in GET /v1/pricing, and GET /v1/billing/plans lists every plan for people with its price.</div></div></details><details class="is_View _fd-column _borderBottomWidth-1px _btc-edge _brc-edge _borderBottomColor-edge _borderLeftColor-edge _bbs-solid" data-slot="disclosure"><summary class="is_View _bg-0hover-panel _fd-row _dsp-flex _items-center _justify-space-betwe3241 _gap-c-space-4 _minH-44px _pt-c-space-4 _pb-c-space-4 _cur-pointer" data-slot="disclosure-summary"><span class="is_Text _col-ink _grow-1 _shrink-1 _fb-0px _fs-f-size-5 _fw-497" data-slot="text">Can an agent sign up without a person?</span><div aria-hidden="true" class="is_View _fd-row _shrink-0" data-slot="disclosure-icon"><svg fill="none" height="16" stroke="var(--quiet)" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" style="color:var(--quiet)" viewbox="0 0 24 24" width="16"><path d="M5 12h14" stroke="var(--quiet)"></path><path d="M12 5v14" stroke="var(--quiet)"></path></svg></div></summary><div class="is_View _fd-column _pb-c-space-5" data-slot="disclosure-content"><div class="is_Text _col-soft _lh-f-lineHeigh112924" data-slot="text">Yes. With a wallet it needs no inbox and no person: it signs a one-time challenge from hanzo.id, a first-seen wallet gets its own account and organization, and it mints a key with the token it gets back. The whole flow is the script above. An agent with an inbox can sign up by email code instead, and one with neither has its person approve a device code once.</div></div></details><details class="is_View _fd-column _borderBottomWidth-1px _btc-edge _brc-edge _borderBottomColor-edge _borderLeftColor-edge _bbs-solid" data-slot="disclosure"><summary class="is_View _bg-0hover-panel _fd-row _dsp-flex _items-center _justify-space-betwe3241 _gap-c-space-4 _minH-44px _pt-c-space-4 _pb-c-space-4 _cur-pointer" data-slot="disclosure-summary"><span class="is_Text _col-ink _grow-1 _shrink-1 _fb-0px _fs-f-size-5 _fw-497" data-slot="text">How does an agent pay?</span><div aria-hidden="true" class="is_View _fd-row _shrink-0" data-slot="disclosure-icon"><svg fill="none" height="16" stroke="var(--quiet)" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" style="color:var(--quiet)" viewbox="0 0 24 24" width="16"><path d="M5 12h14" stroke="var(--quiet)"></path><path d="M12 5v14" stroke="var(--quiet)"></path></svg></div></summary><div class="is_View _fd-column _pb-c-space-5" data-slot="disclosure-content"><div class="is_Text _col-soft _lh-f-lineHeigh112924" data-slot="text">Over the API in stablecoins: GET /v1/billing/crypto/options lists the chains (today Base, Ethereum and Solana) and the tokens (USDC and USDT) the rail accepts, POST /v1/billing/crypto/deposit returns the address to send to, and GET /v1/billing/crypto/deposit/{id} says when it is credited. Cards, Apple Pay and Google Pay go through the checkout at hanzo.ai/pay, which needs a browser.</div></div></details><details class="is_View _fd-column _borderBottomWidth-1px _btc-edge _brc-edge _borderBottomColor-edge _borderLeftColor-edge _bbs-solid" data-slot="disclosure"><summary class="is_View _bg-0hover-panel _fd-row _dsp-flex _items-center _justify-space-betwe3241 _gap-c-space-4 _minH-44px _pt-c-space-4 _pb-c-space-4 _cur-pointer" data-slot="disclosure-summary"><span class="is_Text _col-ink _grow-1 _shrink-1 _fb-0px _fs-f-size-5 _fw-497" data-slot="text">How do I keep an agent from overspending?</span><div aria-hidden="true" class="is_View _fd-row _shrink-0" data-slot="disclosure-icon"><svg fill="none" height="16" stroke="var(--quiet)" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" style="color:var(--quiet)" viewbox="0 0 24 24" width="16"><path d="M5 12h14" stroke="var(--quiet)"></path><path d="M12 5v14" stroke="var(--quiet)"></path></svg></div></summary><div class="is_View _fd-column _pb-c-space-5" data-slot="disclosure-content"><div class="is_Text _col-soft _lh-f-lineHeigh112924" data-slot="text">Give each agent its own key with a monthly budget in cents and a rate in requests a minute: past the budget a call answers 402, past the rate 429. A session can carry its own cap, set with POST /v1/agent/sessions/{id}/budget, and a session that reaches it pauses until the cap is raised.</div></div></details><details class="is_View _fd-column _borderBottomWidth-1px _btc-edge _brc-edge _borderBottomColor-edge _borderLeftColor-edge _bbs-solid" data-slot="disclosure"><summary class="is_View _bg-0hover-panel _fd-row _dsp-flex _items-center _justify-space-betwe3241 _gap-c-space-4 _minH-44px _pt-c-space-4 _pb-c-space-4 _cur-pointer" data-slot="disclosure-summary"><span class="is_Text _col-ink _grow-1 _shrink-1 _fb-0px _fs-f-size-5 _fw-497" data-slot="text">Which tools can my agent use?</span><div aria-hidden="true" class="is_View _fd-row _shrink-0" data-slot="disclosure-icon"><svg fill="none" height="16" stroke="var(--quiet)" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" style="color:var(--quiet)" viewbox="0 0 24 24" width="16"><path d="M5 12h14" stroke="var(--quiet)"></path><path d="M12 5v14" stroke="var(--quiet)"></path></svg></div></summary><div class="is_View _fd-column _pb-c-space-5" data-slot="disclosure-content"><div class="is_Text _col-soft _lh-f-lineHeigh112924" data-slot="text">The native Hanzo MCP server, over stdio from one line in Claude Code, Codex, Cursor and Zed: npx -y hanzo mcp. It carries the Kai decision tools beside files, shell, git, code search, the browser and the computer.</div></div></details></div></section></div></section></main></div>$/$ |