- Notifications
You must be signed in to change notification settings - Fork0
A toolkit for building multimodal AI agents
License
isaka/surfkit
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
A toolkit for building and sharing AI agents that operate on devices
Explore the docs »
View Demo ·Report Bug ·Request Feature
- Build multimodal agents that can operate on devices
- Share agents with the community
- Run agents and devices locally or in the cloud
- Manage agent tasks at scale
- Track and observe agent actions
agentsea_demo.mp4
pip install surfkit
- Docker
- Python >= 3.10
- MacOS or Linux
Use an agent to solve a task
fromsurfkitimportsolvetask=solve("Search for the most common variety of french duck",agent_type="pbarker/SurfPizza",device_type="desktop", )task.wait_for_done()result=task.result
Find available agents on the Hub
surfkit findCreate a new agent
surfkit create agent -t pbarker/SurfPizza -n agent01List running agents
surfkit list agentsCreate an Ubuntu desktop for our agent to use.
surfkit create device --provider docker -n desktop01List running devices
surfkit list devicesUse the agent to solve a task on the device
surfkit solve "Search for the most common variety of french duck" \ --agent agent01 \ --device desktop01View ourdocumentation for more in depth information.
Initialize a new project
surfkit new
Build a docker container for the agent
surfkit build
Create an agent locally
surfkit create agent --name foo -t pbarker/SurfPizza
Create an agent on kubernetes
surfkit create agent --runtime kube -t pbarker/SurfPizza
List running agents
surfkit list agents
Get details about a specific agent
surfkit get agent foo
Fetch logs for a specific agent
surfkit logs foo
Delete an agent
surfkit delete agent foo
Create a device
surfkit create device --type desktop --provicer gce --name bar
List devices
surfkit list devices
View device in UI
surfkit view device bar
Delete a device
surfkit delete device bar
Create a tracker
surfkit create tracker
List trackers
surfkit list trackers
Delete a tracker
surfkit delete tracker foo
Solve a task with an existing setup
surfkit solve"search for common french ducks" --agent foo --device barSolve a task creating the agent ad hoc
surfkit solve"search for alpaca sweaters" \--device bar --agent-file ./agent.yamlList tasks
surfkit list tasks
Login to the hub
surfkit login
Publish the agent
surfkit publish
List published agent types
surfkit find
Skillpacks is integrated with:
- MLLM A prompt management, routing, and schema validation library for multimodal LLMs
- Taskara A task management library for AI agents
- Skillpacks A library to fine tune AI agents on tasks.
- Threadmem A thread management library for AI agents
Come join us onDiscord.
Add the following function to your~/.zshrc (or similar)
functionsk() {local project_dir="/path/to/surfkit/repo"local venv_dir="$project_dir/.venv"local ssh_auth_sock="$SSH_AUTH_SOCK"local ssh_agent_pid="$SSH_AGENT_PID"export SSH_AUTH_SOCK="$ssh_auth_sock"export SSH_AGENT_PID="$ssh_agent_pid"# Add the Poetry environment's bin directory to the PATHexport PATH="$venv_dir/bin:$PATH"# Execute the surfkit.cli.main module using python -m surfkit"$@"}
Replacing/path/to/surfkit/repo with the absolute path to your local repo.
Then callingsk will execute the working code in your repo from any location.
About
A toolkit for building multimodal AI agents
Resources
License
Code of conduct
Stars
Watchers
Forks
Languages
- Python89.5%
- JavaScript9.8%
- Other0.7%