by hcompai
Run Surfer-H agents powered by Holo1 using the Surfer-H-CLI. Includes example tasks, scripts, and configurations.
# Add to your Claude Code skills
git clone https://github.com/hcompai/surfer-h-cli🌐 Website | 📖 Tech report | 🤗 Hugging-Face Models | 🏄 Surfer-H product | ☁️ AWS Model Deployment
<div align="center">Introducing the latest range of Holo models: Holo1.5 State-of-the-art Foundational Models for Computer Use Agents
</div>The Holo models are H Company’s Action Vision-Language Models (VLMs) and Surfer-H is the agent that enacts them in the real world. Together, they provide a powerful, automated, yet optimized solution to interacting with web interfaces the way we do—setting a goal, taking decisions, re-thinking and re-assessing where needed, and, ultimately, fulfilling everyday tasks. Holo models and Surfer-H have been designed and built to do everything from booking flights, to searching for recipes online, and more.
The Surfer-H-CLI is the command-line interface for running and controlling the Surfer-H agent, allowing you to define tasks, connect to Holo models, and execute web interactions directly from your terminal.
To get started, first generate an API key at: https://portal.hcompany.ai. This API key will allow you to run inference on H company models. Guide: generate an API key
Next, copy the example env variables.
cp .env.example .env
Enter your newly generated HAI_API_KEY in your .env
Or setup globally: Add these to your or files:
.zshrc.bashrcexport HAI_API_KEY=...
export HAI_MODEL_URL=...
export HAI_MODEL_NAME=...
Running via the CLI:
./run-on-holo.sh
Running with holo1.5 as localizer (best performance):
./run-on-holo-1-5.sh
Running with the frontend interface:
./launch.sh
This command will automatically start both the Surfer-H backend and the Next.js frontend, making the web interface available at http://localhost:3000.
Holo1 and Holo1.5 are Action Vision-Language Models (VLMs) developed by H Company for use in Surfer-H. The Holo models enable the agent to understand and act in digital environments. Holo is built based on 3 core components that shape and determine its behaviour: policy, localizer, and validator. These are defined below:
Trained on...