Quickstart - AgentSea

Overview

These are the basic steps to getting up and running:

Install surfkit
Create an agent instance
Create a device
Launch your agent to solve a task

Prerequisites

Docker
Python >= 3.10
MacOS or Linux
Poetry

If you want to create a desktop using Docker, that is all you need. To create a desktop with other providers:

Install QEMU OR Configure GCP OR Configure AWS

If you are using Docker Desktop on MacOS, please update the settings: go to Settings | Advanced and make sure that the checkbox Allow the default Docker socket to be used (requires password) is checked. Save the settings, apply and restart.

Install Surfkit

pip install surfkit

Run an Agent

Clone Robbie Gen 2 repository

git clone git@github.com:agentsea/robbie-g2.git && cd robbie-g2

Install dependencies

poetry install

Create a new agent

surfkit create agent -n agent01

List running agents

surfkit list agents

Automatically add local API keys

Agents will prompt you for any keys they need. In order to skip this and automatically add local keys

surfkit create agent --local-keys

View agent logs

View all agent logs

surfkit logs agent <name>

Follow logs

surfkit logs agent <name> --follow

Create a Device

Now that we’ve installed our agent, we need to give it a device to use. The fastest way to get up and running is to use Docker, but the most scalable is to create devices in GCP or AWS. To create an Ubuntu desktop for our agent to use, select one of the following options ▼

Create a local desktop using Docker

Requirements

Docker installed
At least 16GB of RAM

surfkit create device --provider docker -n desktop01

You can also skip the provider flag, because docker is the default provider:

surfkit create device  -n desktop01

Create a local desktop using Qemu

Requirements

QEMU installed (macOS, linux)
At least 16GB of RAM

surfkit create device --provider qemu -n desktop01

Create a desktop on GCE

Requirements

gcloud installed
Logged in to an account with create permissions for GCE*

surfkit create device --provider gce -n desktop01

* Read this for more details on how to configure GCE to create desktop VMs

Create a desktop on EC2

Requirements

Authentication configured with create permissions for EC2*

surfkit create device --provider ec2 -n desktop01

* Read this for more details on how to configure AWS to create desktop VMs

List running devices

surfkit list devices

Create a Tracker

Before solving a task, we have the choice to create a tracker, which is a task server that tracks tasks for us in a Docker container.

surfkit create tracker -n tracker01 -r docker

Solve a task

Use the agent to solve a task on the device

surfkit solve "Search for the most common variety of french duck" \
  --agent agent01 \
  --device desktop01 \
  --tracker tracker01

If you don’t create tracker explicitly before launching an agent, which you pass to the solve command via the --tracker flag, surfkit will ask if you want to create a tracker automatically.

What’s next

Now that you have a feel for the basics, you can move on to more advanced topics, like learning about all the tools in the surfkit or creating your own agent.

Create an Agent

Create your own agent

Learn more

Learn more about the tools

​Overview

​Prerequisites

​Install Surfkit

​Run an Agent

​Create a Device

​Create a Tracker

​Solve a task

​What’s next

Create an Agent

Learn more

Overview

Prerequisites

Install Surfkit

Run an Agent

Create a Device

Create a Tracker

Solve a task

What’s next