Repolode
Submit
deathbyknowledge

deathbyknowledge/gsv

A personal AI agent that runs as a control plane in your own Cloudflare account and acts across your laptop, server, phone and browser.

View on GitHubWebsite
Stars
131
Forks
15
Open issues
25
Last commit
yesterday

What is it?

Ship, also called GSV, is an open-source personal assistant that deploys a lightweight control plane into your own Cloudflare account. Instead of depending on a single host you keep running, the agent stays reachable at the edge while devices connect to it outbound-only, so your laptop, home server, phone and browser can act as one environment.

Agents are durable processes with their own identities, memory, history, permissions and subprocesses. Devices and the browser extension expose the same filesystem and shell interface, so the same commands work whether they run in the cloud or on a connected machine. A built-in git remote keeps repositories inspectable, and adapters for Discord, Telegram and Slack let you reach the agent from messaging apps.

The project is written in TypeScript and Rust, is MIT licensed, and requires a Cloudflare Workers Paid plan plus separately billed model usage for the public composition.

Key features

  • 01Deploys a control plane into your own Cloudflare account.
  • 02Connects laptops, servers and browsers outbound-only, with no open ports or VPN.
  • 03Durable agent processes with memory, permissions and subprocesses.
  • 04Web UI, CLI and adapters for Discord, Telegram and Slack.
  • 05Built-in git remote for repositories and knowledge.
  • 06Browser extension that lets the agent work in your logged-in tabs.

Use cases

  • Running a job on a home server while your laptop is offline.
  • Chatting with a personal agent from Discord, Telegram or Slack.
  • Letting an agent work on files and shells across several personal machines.
  • Spawning sub-agents with separate memory and permissions for different tasks.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/deathbyknowledge/gsv.git
  2. 2

    Install dependencies (after cd gsv; Node.js and Rust required)

    npm ci
  3. 3

    Set the Cloudflare env vars, run alchemy login and bootstrap, then deploy the operator stage

    npm run deployment:deploy
  4. 4

    Run the official install script from the README to get the CLI

Things to know

  • Requires a Cloudflare Workers Paid plan and a domain in a Cloudflare DNS zone.
  • Model usage is billed separately by your model provider.
  • The project is in public beta and may change.

In collections

Open-source AI agent frameworks & appsSelf-hosted appsAI chatbots & chat clientsOpen-source personal AI agents

Topics

#personal-agent#ai#cloudflare#typescript#rust#self-hosted#agents#chatbot#artificial-intelligence#personal-assistant

FAQ

What is gsv?
A personal AI agent that runs as a control plane in your own Cloudflare account and acts across your laptop, server, phone and browser. Ship, also called GSV, is an open-source personal assistant that deploys a lightweight control plane into your own Cloudflare account. Instead of depending on a single host you keep running, the agent stays reachable at the edge while devices connect to it outbound-only, so your laptop, home server, phone and browser can act as one environment.
Is gsv free to use? What license does it have?
gsv is open source under the MIT license. Check the license terms before using it in commercial products.
Is gsv still maintained?
Actively maintained. The last commit to gsv was on Nov 6, 2026.
What can I use gsv for?
Running a job on a home server while your laptop is offline. Chatting with a personal agent from Discord, Telegram or Slack. Letting an agent work on files and shells across several personal machines. Spawning sub-agents with separate memory and permissions for different tasks.
How do I install gsv?
Clone the repository: git clone https://github.com/deathbyknowledge/gsv.git Install dependencies (after cd gsv; Node.js and Rust required): npm ci Set the Cloudflare env vars, run alchemy login and bootstrap, then deploy the operator stage: npm run deployment:deploy Run the official install script from the README to get the CLI
Where can I get gsv?
The source code and installation instructions are on GitHub: https://github.com/deathbyknowledge/gsv

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects