Skip to main content
H Company’s Surfer-H-CLI is an open-source, lightweight version of Surfer-H that lets you launch the agent and execute runs from the command line or the frontend interface. It is a preview of what the Surfer-H agent can do when powered by our Holo vLLM models.

Surfer-H-CLI

This section explains the architecture of the open-source Surfer-H-CLI and how its components fit together.

Architecture

The Surfer-H-CLI has three components:
  • The Surfer-H agent: An open-source version of H’s Surfer-H AI agent that automates browsing, data extraction, and workflow execution.
  • H’s Holo models: The vLLM that powers Surfer-H. H’s Holo models interpret web pages, understand user intent, and generate actions and responses.
  • A frontend interface: A web frontend for interacting with the agent: creating tasks, monitoring tasks, and managing trajectories.
The command line interface brings these together so you can see how the agent, Holo models, and frontend interface work together. With the Surfer-H-CLI, you can:
  • Launch the Surfer-H agent from the command line.
  • Define tasks and execute runs, like “find a beef wellington recipe” or “search for iPhones.”
  • Launch the Surfer-H web interface to watch the agent work in real time.
  • Interact with the agent through the web interface, modifying tasks as needed.

Get started

The steps below show you how to start executing runs.
1

Set up your environment

Deploy the Holo model by configuring your environment variables.
2

Run the Surfer-H agent

Use the Surfer-H-CLI to call the Surfer-H agent and run a task.
3

Launch the frontend (Optional)

Use our modern web frontend to interact with the agent visually.