A mind for your machines, by Humans & Machines, Inc.
🛸 Public beta — coming before July. Issues and PRs very welcome.
Most personal AI agents run on one host you pick and keep alive — a laptop, a VPS, a container. GSV turns all your devices into a single computer. It spans your laptop, server, and phone at once, lets an agent act on whichever one fits, and runs on the edge in your own Cloudflare account; your keys, your data, no host to provision or babysit. From ~$5/mo infra plus your own model costs.
- Run things across all your machines from one agent — kick off a job on your home server while your laptop's shut.
- Keep agents working while your devices sleep — they live on the edge, not your hardware.
- Reach it from anywhere — web UI, CLI, or Whatsapp / Discord / Telegram.
- Spawn durable agents with their own memory, permissions, and the ability to start sub-agents.
- Host your own packages and share apps between GSV instances through a built-in git remote.
Under the hood it's a distributed OS: agents are durable processes with identities, history, permissions, and a syscall surface, plus an SDK for building apps. Named after the sentient ships from Iain M. Banks' Culture series, GSV (General Systems Vehicle) is a foundation for personal AI that lives across the edge.
Prerequisite: a Cloudflare account on the Workers Paid plan ($5/month).
# Install CLI
curl -sSL https://install.gsv.space | bash
# Deploy all components to your Cloudflare account
gsv infra deploy --api-token <CLOUDFLARE-API-TOKEN>Open the URL it prints to finish onboarding in the Web UI. Then chat from the UI, a connected adapter (Discord/Telegram/Whatsapp), or the CLI:
gsv chat "Hello, what can you help me with?"Connected devices are reachable by your agents from anywhere — outbound-only, so no open ports, no inbound connections, no VPN. Add one via GSV > Devices in the Web UI, or the CLI:
gsv auth token create --device macbook --label Macbook # note the token
gsv config --local set node.token <token>
gsv device install --id macbook --workspace ~/ # background service
gsv device statusNow GSV can use the shell and read/write files on that machine. Set up adapters under GSV > Integrations.
Linux-like by design, so agents can reason with familiar patterns (mental model, not POSIX).
- Kernel — the Gateway runs on Cloudflare, exposing authenticated syscalls (
proc.*,pkg.*,sys.*). - Processes — agents are durable processes with PIDs (
gsv proc list|spawn|send|kill). - Devices — connected machines act as execution nodes, scoped to a workspace.
- Adapters — Discord/Telegram/Whatsapp workers act like device drivers for external chat.
./scripts/setup-deps.sh # install JS deps across workspace, adapters, ripgit
cd web && npm run build # build web app
cd .. && npm run dev # local multi-worker dev stackRequires Rust and Node.js + npm.
GSV is actively evolving, and we want you to be part of the network! We welcome contributions of all sizes. Whether you want to submit a pull request, share a wild idea, or just say hi, please don't hesitate to reach out. :)
- Join the Community: Come hang out, talk shop, and share ideas on our Discord Server.
- Found a bug or have a feature request? Open an issue.
- Follow Updates: Reach out directly on Twitter/X @humachinesinc
MIT