• Managed — we handle the AI. 20 free tasks/month, then $0.05/task. No API key needed.
• BYOM — use your Claude Pro/Max subscription, GPT Plus, or any API key. Free forever, runs locally.

Examples

"Go to Gmail and unsubscribe from all marketing emails from the last week"
"Apply for the senior engineer position on careers.acme.com"
"Log into my bank and download last month's statement"
"Find AI engineer jobs on LinkedIn in San Francisco"

Skills

The setup wizard installs browser skills into your agent automatically. Skills teach your agent when and how to use the browser for specific workflows:

| Skill | Description | |-------|-------------| | hanzi-browse | Core skill — when and how to use browser automation | | e2e-tester | Test your app in a real browser, report bugs with screenshots | | social-poster | Draft per-platform posts, publish from your signed-in accounts | | linkedin-prospector | Find prospects, send personalized connection requests | | a11y-auditor | Run accessibility audits in a real browser | | x-marketer | Twitter/X marketing workflows |

Open source — add your own.

Build with Hanzi Browse

Embed browser automation in your product. Your app calls the Hanzi API, a real browser executes the task, you get the result back.

1. Get an API key — sign in to your developer console, then create a key
2. Pair a browser — create a pairing token, send your user a pairing link (/pair/{token}) — they click it and auto-pair
3. Run a task — POST /v1/tasks with a task and browser session ID
4. Get the result — poll GET /v1/tasks/:id until complete, or use runTask() which blocks

import { HanziClient } from '@hanzi/browser-agent';

const client = new HanziClient({ apiKey: process.env.HANZI_API_KEY });

const { pairingToken } = await client.createPairingToken();
const sessions = await client.listSessions();

const result = await client.runTask({
  browserSessionId: sessions[0].id,
  task: 'Read the patient chart on the current page',
});
console.log(result.answer);

API reference · Dashboard · Sample integration

Tools

| Tool | Description | |------|-------------| | browser_start | Run a task. Blocks until complete. | | browser_message | Send follow-up to an existing session. | | browser_status | Check progress. | | browser_stop | Stop a task. | | browser_screenshot | Capture current page as PNG. |

Pricing

| | Managed | BYOM | |--|---------|------| | Price | $0.05/task (20 free/month) | Free forever | | AI model | We handle it (Gemini) | Your own key | | Data | Processed on Hanzi servers | Never leaves your machine | | Billing | Only completed tasks. Errors are free. | N/A |

Building a product? Contact us for volume pricing.

Development

Prerequisites: Node.js 18+, Docker Desktop (must be running).

First time

git clone https://github.com/hanzili/hanzi-browse
cd hanzi-browse
make fresh

This checks prerequisites, creates .env from the template, installs dependencies, builds everything, starts Postgres, runs migrations, and starts the dev server. Takes about 90 seconds.

Every time after

make dev

Starts Postgres + migrations + dev server. Dashboard at localhost:3456/dashboard.

Commands

| Command | What it does | |---------|-------------| | make fresh | Full first-time setup (prereqs + deps + build + DB + start) | | make dev | Start everything (DB + migrate + server) | | make build | Rebuild server + dashboard + extension | | make stop | Stop Postgres | | make clean | Stop + delete database volume | | make check-prereqs | Verify Node 18+ and Docker are available | | make help | Show all commands |

Configuration

The defaults in .env.example are enough to run the server. Optional services:

• Google OAuth (dashboard sign-in) -- add GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET to .env
• Stripe (credit purchases) -- add test keys to .env
• Vertex AI (managed task execution) -- see .env.example for setup steps

Load the extension

Open chrome://extensions, enable Developer Mode, click "Load unpacked", select the dist/ folder.

Contributing

We welcome contributions! See CONTRIBUTING.md for setup instructions.

Good first contributions: new skills, landing pages, site-pattern files, platform testing, translations. Check the open issues.

Community

Discord · Documentation · Twitter

Privacy

Hanzi operates in different modes with different data handling. Read the privacy policy.

• BYOM: No data sent to Hanzi servers. Screenshots go to your chosen AI provider only.
• Managed / API: Task data processed on Hanzi servers via Google Vertex AI.

License

Polyform Noncommercial 1.0.0