Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 8 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,25 @@
# GSV

![gsv](https://github.com/user-attachments/assets/fd40032c-d551-44e4-ba77-7808d29cc0a1)
> ***A mind for your machines, by [Humans & Machines, Inc.](https://humanandmachin.es)***

> ***A mind for your machines, by [Humans & Machines, Inc.](https://humansandmachin.es)***

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![Release](https://img.shields.io/github/v/release/deathbyknowledge/gsv)](https://github.com/deathbyknowledge/gsv/releases)
[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/hy9ExJJFvn)
[![X](https://img.shields.io/badge/X-@humachinesinc-000?logo=x&logoColor=white)](https://x.com/humachinesinc)
[![Website](https://img.shields.io/badge/site-gsv.space-111)](https://gsv.space)
[![Docs](https://img.shields.io/badge/docs-gsv.space-111)](https://gsv.space)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/deathbyknowledge/gsv)

> **GSV is actively baking! 🏗️**
> 🛸 Public beta — coming before July. Issues and PRs very welcome.
**🛸 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.

## 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 your hardware.
- Reach it from anywhere — web UI, CLI, or Discord / Telegram.
- 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.

Expand All @@ -44,7 +45,7 @@ curl -sSL https://install.gsv.space | bash
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 (WhatsApp/Discord/Telegram), or the CLI:
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:

```bash
gsv chat "Hello, what can you help me with?"
Expand All @@ -70,7 +71,7 @@ Linux-like by design, so agents can reason with familiar patterns (mental model,
- **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** — WhatsApp/Discord/Telegram workers act like device drivers for external chat.
- **Adapters** — Discord/Telegram/Whatsapp workers act like device drivers for external chat.

## Development

Expand All @@ -82,7 +83,6 @@ cd .. && npm run dev # local multi-worker dev stack

Requires [Rust](https://rustup.rs) and [Node.js + npm](https://nodejs.org).


## 🤝 Get Involved

GSV is actively evolving, and we want you to be part of the network! We welcome contributions of all sizes.
Expand All @@ -92,8 +92,6 @@ Whether you want to submit a pull request, share a wild idea, or just say hi, pl
- **Found a bug or have a feature request?** [Open an issue](https://github.com/deathbyknowledge/gsv/issues).
- **Follow Updates:** Reach out directly on Twitter/X [@humachinesinc](https://x.com/humachinesinc)



## License

MIT
Loading