H Company’s Surfer-H-CLI is an open-sourced, lightweight version of Surfer-H that lets you launch the agent and execute runs straight from the command line or frontend interface. It’s a preview of what we’re building and an example of everything the Surfer-H agent can do when powered by our Holo vLLM models. By open-sourcing the Surfer-H-CLI, we’re proudly sharing what we’ve built so far and providing a small but important glimpse of what’s to come.

​
Surfer-H-CLI

This section explains the architecture of the open-sourced Surfer-H-CLI, how its core components fit together, and the benefits it provides to users and developers.

​
Architecture

The Surfer-H-CLI is made up of three core components:
  • The Surfer-H agent: An open-sourced version of H’s Surfer-H AI agent that automates browsing, data extraction, and workflow execution.
  • H’s Holo models: The vLLM powering Surfer-H. H’s Holo models interpret web pages, understand user intent, and generate actions and responses.
  • A frontend interface: A modern web frontend that provides an intuitive way to interact with the agent, create tasks, monitor tasks, manage trajectories, and more.
Using the command line interface, Surfer-H-CLI brings the above together, offering a simple but powerful way to explore how the agent, Holo models, and frontend interface work in concert. 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 see the agent working in real-time.
  • Interact with the agent via the web interface, modifying tasks and adjusting when needed.

​
Get started

The Surfer-H-CLI lets you experience the power of the Surfer-H framework, and the Holo models that charge it, first hand. The steps below show you how to start executing runs in minutes.
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.