allenpeng0705/EnvoyMesh

Decentralized P2P mesh for autonomous AI agents — self-sovereign identity, peer-to-peer chat, and on-device AI that negotiates tasks on your behalf. No central server.

EnvoyMesh – A Private, Decentralized Mesh for AI Agents

What it is – EnvoyMesh is a peer‑to‑peer (P2P) social platform that runs on the user’s own devices. It lets you chat, call, share files, and host a personal knowledge base without any central server. In addition, each node bundles an AI assistant (EnvoyAI / OpenClaw) and can connect to an external AI engine through a secure bridge, so the assistant can act on your behalf – e.g., negotiate tasks, search your notes, or run code – while your cryptographic identity (Ed25519 keys) stays under your control.

Core capabilities

Category	What you can do
Communication	Direct P2P text chat, group rooms, voice calls (WebRTC), audio notes, and content‑addressed file sharing. All messages are signed and pass a four‑step security pipeline (authenticity → trust list → policy → replay protection).
AI assistant	Built‑in EnvoyAI (OpenClaw) runs on the node (port 18789) and can read your vault, contacts, and send messages. You can also attach a single external AI engine (HomeClaw, Hermes, OpenHuman, or any HTTP‑compatible agent) via a bridge that signs and policies every request.
Knowledge base	In‑app markdown notes with per‑item sensitivity labels, automatic RAG re‑indexing, and an optional Obsidian plugin that syncs a vault to the mesh. Public notes are queryable by any peer; private notes stay local.
Agent network	Create “fleets” for teams, assign multi‑step jobs to bonded agents, configure cost‑rebalance policies, and view detailed reports. A marketplace lets you discover capability providers and negotiate tasks.
Mobile access	EnvoyGo (Flutter) is a thin client for iOS/Android that pairs with your desktop home node via QR code, giving you chat, AI, terminal, and voice calls on the go.
Family mode	One home node can host multiple profiles – each family member gets a separate AI history and UI view while sharing the same underlying model configuration.

How it works (high‑level)

Identity – Each user controls an Ed25519 key pair and a DID (decentralized identifier). The key never leaves the device.
Mesh – Nodes connect directly or via a relay that only forwards encrypted envelopes; the relay never reads the payload.
Security pipeline – Every envelope is verified (signature), checked against your trust list, filtered by a policy engine, and deduplicated before delivery.
Agent bridge – The bridge translates mesh messages to plain HTTP for an AI engine. The engine never sees your private keys; EnvoyMesh signs all outbound messages and enforces your policies.
RAG – When the AI needs knowledge, it queries the local vault and can fan‑out the request to bonded peers’ public vaults, then syntheses the answers.

Getting started (end‑user)

Download – Grab the desktop installer for macOS, Windows, or Linux from the Download section (or the mirror links). Install and launch; the app auto‑bonds to the project author as a starter contact.
Pair a phone – Install EnvoyGo from the App Store or Google Play, scan the QR code shown in the desktop UI, and you’ll have a synced profile on your phone.
Chat & AI – Use the Social UI (http://localhost:5173 when running from source) to start conversations, create rooms, or ask the built‑in AI for help.
Optional external AI – Run a compatible agent (e.g., hermes serve) and enable it in Settings → AI → AI Engine; the bridge will forward messages to the external service.

Getting started (developer)

# Clone the repo
git clone https://github.com/allenpeng0705/EnvoyMesh.git
cd EnvoyMesh

# Run the provided setup script – it also clones the sibling envoy‑harness repo
./scripts/setup.sh   # or .\scripts\setup.ps1 on Windows

# Start the node and the web UI
npm run node:dev      # P2P node
npm run social:dev    # opens http://localhost:5173

The repo requires Node ≥ 22.13, pnpm, and a sibling envoy-harness repository (the coding‑agent runtime). Desktop builds are produced with Tauri (./scripts/build-desktop.sh).

Current status

Beta‑ready desktop app – downloadable binaries are published on GitHub releases.
Mobile client (EnvoyGo) – available on iOS 18.6+ and Android via the official stores.
Built‑in AI (OpenClaw) is functional and runs in‑process; external bridge support is documented and works with the three bundled presets.
Knowledge‑base integration (markdown editor, Obsidian plugin, federated RAG) is implemented.
Roadmap items – video calls, richer marketplace features, and more external‑agent adapters are listed in the guidebook.

Who might find this useful?

Privacy‑focused users who want a social network and AI assistant that never leaves their hardware.
Teams or families that need a shared, self‑hosted collaboration space with AI‑driven task automation.
Developers interested in building custom AI agents or extending the mesh (new knowledge‑base plugins, alternative external agents, etc.).

TL;DR – EnvoyMesh is a full‑stack, self‑hosted P2P platform that combines secure messaging, a personal knowledge vault, and plug‑in‑able AI agents, all under the user’s own cryptographic identity.