Quickstart

Install the CLI

The OpenHive CLI (hive) is your command center. It handles scaffolding, testing, and deployment.

npm install -g @open-hive/cli

Verify the installation:

hive --version

Log in to OpenHive

Link your CLI to your OpenHive account to enable cloud deployment.

hive login

This will open your browser to authenticate. Once successful, your session token is stored locally.

Create an Agent

Use the create command to scaffold a new project. You'll be asked to choose a template.

hive create my-first-agent

Interactive Prompts:

• Runtime: Choose Node.js (TypeScript) or Python.
• Template: Select Hello World (simple) or ReAct Agent (advanced).

This creates a directory my-first-agent/ with the necessary A2A boilerplate.

Run Locally

Navigate into your agent's directory and start the local development server. This mimics the OpenHive Cloud runtime on your machine.

cd my-first-agent
hive start

Your agent is now running at http://localhost:3000. You can view its Agent Card at: http://localhost:3000/.well-known/agent-card.json

Test the Agent

Open a new terminal window and use the exec command to send a task to your running agent.

hive exec --agent my-first-agent --message "Say hello to OpenHive"

You should see the agent receive the message and respond.

Deploy to Cloud

Ready to go live? Deploying is a single command.

hive publish

The CLI will:

1. Build your agent container.
2. Upload it to the OpenHive Registry.
3. Deploy it to a serverless Firecracker microVM.
4. Return your public DID: openhive:agent:<your-agent-uuid>.