Skip to content
Try Hanzo
Language: English (United States)

Hanzo Operative

Computer use, in a container

A container with a Linux desktop inside it, and a model driving that desktop by screenshot, mouse and keyboard.

ghcr.io/hanzoai/operative:latest

Say what you want

Star on GitHub

  1. plansScreen Visionlocalhost:8501
  2. plansMultimodal ModelsOpen Source on GitHub
  3. actsCursor ControlStar on GitHub
  4. looks at the resultScreen VisionGitHub

You can interrupt at any point.

The container's hands01 / 04

One docker run

Nothing is installed on your machine. The desktop, the tools and the agent are all inside the image

Installation
  1. 1

    Pull the image

    $ docker pull ghcr.io/hanzoai/operative:latest
  2. 2

    Run it with your key and the four ports

    $ docker run -e ANTHROPIC_API_KEY -p 8501:8501 -p 6080:6080 -p 5900:5900 -p 8080:8080 -it ghcr.io/hanzoai/operative:latest
  3. 3

    Open localhost:8501 and type an objective

operative
8501the control page
6080noVNC on 6080 in a browser
5900VNC on 5900 for a native client
8080

System Requirements

  • • Docker. Nothing else installed on the host
  • • A key for the API, Bedrock, or Vertex
  • • Four ports free: 8501, 6080, 5900, 8080
  • • Give the container the fewest privileges that work

Basic Usage

  • Watch it in a browser, no VNC client needed

    open http://localhost:6080
  • Send the model through Bedrock instead

    docker run -e API_PROVIDER=bedrock -e AWS_PROFILE -e AWS_REGION=us-west-2 …
  • Or through Vertex

    docker run -e API_PROVIDER=vertex -e VERTEX_REGION -e VERTEX_PROJECT_ID …
  • Keep the session between runs

    docker run -v $HOME/.anthropic:/home/operative/.anthropic …

Computer use is beta, and instructions written into a web page or an image can try to talk to the model as if they were you. Limit outbound traffic to domains you name, and ask for a human yes before anything with consequences outside the container.

What is in the container

A screen, a way to watch it, and the tools the model drives it with

Xvfb and X11 give the container a screen with no monitor attached, so a real window manager and real applications run inside it.

Open Source on GitHub

See Operative in Action

Watch as Hanzo Operative uses multimodal AI to router interfaces, complete tasks, and solve problems autonomously.

  1. 01plans
  2. 02acts
  3. 03looks at the result
  4. 04goes again

Get Operative

Computer-use harness

License: Apache-2.0hanzoai

Where the model comes from

One environment variable decides. The container, the desktop and the tools are identical in all four cases

$ docker run -e HANZO_API_KEY … ghcr.io/hanzoai/operative:latest

HanzoRecommended

by The default

  1. Runs through api.hanzo.ai
  2. Every run shows up in the console with its cost
  3. Bring a Hanzo key, or one you already have

Pick the model in the sidebar

docker run -e HANZO_API_KEY …

Which model a provider offers changes; the container does not. The documentation lists what each one currently accepts.

Run it and watch

The most useful hour you can spend with computer use is the first one, watching where it gets stuck.