GSV

a mind for your machines

🚀 Public beta is here! Issues and PRs very welcome.

GSV is an open-source, user-owned personal intelligence system. It gives you one intelligence layer with durable memory, processes, permissions, and the ability to act across all your machines while remaining under your control.

Most personal AI agents run on one host you pick and keep alive — a laptop, VPS, or container. GSV instead deploys a lightweight, always-reachable control plane into your own Cloudflare account and turns your laptop, server, phone, and browser into one computer. Your GSV control plane and state remain in infrastructure you control; the model provider you configure necessarily receives the inference data routed to it. The baseline can fit within Workers Free, plus model usage; Workers Paid adds CodeMode and more runtime capacity.

What you can do

• 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 on your hardware.
• Reach it from anywhere — web UI, CLI, or an extensible adapter system with WhatsApp, Discord, Telegram, and Slack implementations bundled today.
• Spawn durable agents with their own memory and permissions, that can start sub-agents of their own.
• Keep your repositories and knowledge source-inspectable through a built-in git remote.
• Hand your agent the browser. The web extension lets it drive your real browser — your tabs and logged-in sessions — so it works the sites you already use, not just the public web.

Under the hood, GSV is a distributed operating environment: agents are durable processes with identities, history, permissions, and a capability-gated syscall surface. Named after the sentient ships from Iain M. Banks' Culture series, GSV (General Systems Vehicle) is a foundation for personal intelligence that lives across the edge and the machines you already own.

Quick Start

Prerequisites: a Cloudflare account, plus any credentials required by your chosen model provider. The baseline deployment supports Workers Free; Workers Paid is optional for CodeMode and additional runtime capacity. Model usage is billed separately by its provider.

1. Deploy

From the web (easiest, no terminal). Go to deploy.gsv.space, connect your Cloudflare account, and GSV deploys itself into it.

Or deploy the open-source stack from the terminal:

git clone https://github.com/deathbyknowledge/gsv.git
cd gsv
npm ci
npx alchemy login
npx alchemy cloudflare bootstrap
npm run deployment:deploy

Either way, open the deployed Gateway URL to finish onboarding in the web UI.

Install the CLI, machine daemon, and Desktop separately where supported:

curl -fsSL https://install.gsv.space | bash

The verified host installer ships matching versions of gsv and gsvd on Linux x64/ARM64, macOS Intel/Apple Silicon, and Windows x64. Linux and macOS also receive the native Desktop plus its isolated local transcription and gesture-vision helpers; launch it with gsv desktop. See the host application install and upgrade guide for platform details and service rollback behavior.

2. Start using it

Chat from the web UI right away, or from the CLI:

gsv chat "Hello, what can you help me with?"

To connect a messenger (Discord / Telegram / WhatsApp), add more devices, and see what to do next, follow the full guide at docs.gsv.space/get-started.

Connect a Device

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 --kind device --device macbook --label Macbook  # note the token
gsv config --local set device.token <token>
gsv daemon install --id macbook --workspace ~/  # background service
gsv daemon status

Now GSV can use the shell and read/write files on that machine. Set up adapters under GSV > Integrations.

How GSV Works

GSV uses Linux as a design model (not POSIX, though). Familiar, composable primitives make the system understandable to both people and models.

• Cloud computer — a small, globally reachable hub running in your Cloudflare account. It coordinates identity, state, routing, schedules, and agent loops rather than performing heavy local computation.
• Kernel and syscalls — humans, agents, and the CLI use the same capability-gated primitives for processes, files, shells, networking, repositories, and configuration. The public client exposes those contracts to other clients.
• Processes — agents are durable processes with PIDs, histories, permissions, pending work, and subprocesses (gsv proc list|spawn|send|kill).
• Targets — the cloud runtime and connected devices implement the same targetable filesystem, shell, and network contracts. The browser extension exposes the browser through the same filesystem and shell shape. Changing the target changes where work runs, not what the syscall means.
• Agent tools — models see a deliberately small surface: Read, Write, Edit, Delete, Search, Shell, and CodeMode. Devices and integrations extend the system underneath those tools instead of making the tool list grow forever.
• Adapters — independently deployed Workers translate external services into stable GSV actors, surfaces, and messages. The repository bundles several implementations, while the AdapterService contract remains open to new providers.

Development

./scripts/setup-deps.sh        # install workspace and worker dependencies
npm run build --workspace web  # build assets served by the gateway
npm run dev                    # start the local multi-worker stack
GSV_MANAGED_SERVICES_ROOT=/path/to/services npm run dev:managed

The public repository does not ship a platform operator's Accounts or funded Inference implementation. Supplying compatible accounts/ and inference/ packages starts those services with the Gateway and ripgit on http://localhost:8976. See service contracts for the required boundaries.

Requires Rust and Node.js 22 or newer with npm.

🤝 Get Involved

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 @gsvspace

License

MIT