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 – AI 에이전트를 위한 개인적이고 분산형 메시

무엇인가요 – EnvoyMesh는 사용자의 자체 장치에서 실행되는 피어 투 피어(P2P) 소셜 플랫폼입니다. 중앙 서버 없이 채팅, 통화, 파일 공유, 개인 지식 기반을 호스팅할 수 있습니다. 각 노드에는 AI 어시스턴트(EnvoyAI / OpenClaw)가 내장되어 있으며, 보안 브리지를 통해 외부 AI 엔진에 연결할 수 있어, 작업 협상, 노트 검색, 코드 실행 등 사용자의 대리로 행동할 수 있습니다. 암호화된 신원(Ed25519 키)은 항상 사용자의 통제 하에 있습니다.

핵심 기능

카테고리	수행 가능한 작업
통신	직접 P2P 텍스트 채팅, 그룹룸, 음성 통화(WebRTC), 오디오 노트, 콘텐츠 주소 기반 파일 공유. 모든 메시지는 서명되며, 4단계 보안 파이프라인(authenticity → 신뢰 목록 → 정책 → 재전송 방지)을 통과합니다.
AI 어시스턴트	노드에서 실행되는 내장형 EnvoyAI(OpenClaw)는 포트 18789에서 작동하며, 백업, 연락처를 읽고 메시지를 보낼 수 있습니다. 또한 HomeClaw, Hermes, OpenHuman 또는 HTTP 호환 에이전트를 브리지로 연결하여 단일 외부 AI 엔진을 추가할 수 있습니다. 브리지는 모든 요청에 서명하고 정책을 적용합니다.
지식 기반	앱 내 마크다운 노트, 항목별 민감도 레이블, 자동 RAG 재색인, 메시에 백업을 동기화하는 옵션의 Obsidian 플러그인. 공개 노트는 어떤 피어도 검색 가능하지만, 개인 노트는 로컬에 유지됩니다.
에이전트 네트워크	팀용 '플릿' 생성, 결합된 에이전트에게 다단계 작업 할당, 비용 재균형 정책 구성, 상세 보고서 확인. 마켓플레이스를 통해 기능 제공자 탐색 및 작업 협상 가능.
모바일 접근	EnvoyGo(Flutter)는 iOS/Android용 슬림 클라이언트로, QR 코드로 데스크톱 홈 노드와 페어링되어 모바일에서 채팅, AI, 터미널, 음성 통화를 가능하게 합니다.
가족 모드	하나의 홈 노드에서 여러 프로필을 호스팅할 수 있습니다. 각 가족 구성원은 별도의 AI 기록과 UI 뷰를 가지되, 동일한 모델 구성은 공유합니다.

작동 방식(개요)

신원 – 각 사용자는 Ed25519 키 쌍과 DID(분산 식별자)를 소유합니다. 키는 장치를 벗어나지 않습니다.
메시 – 노드는 직접 또는 리레이를 통해 연결되며, 리레이는 암호화된 봉투만 전달하고 본문은 읽지 않습니다.
보안 파이프라인 – 모든 봉투는 서명 검증, 신뢰 목록 확인, 정책 엔진 필터링, 중복 제거 후 전달됩니다.
에이전트 브리지 – 브리지는 메시를 일반 HTTP로 변환합니다. 엔진은 사용자의 개인 키를 보지 않으며, EnvoyMesh가 모든 출력 메시지에 서명하고 정책을 강제합니다.
RAG – AI가 지식이 필요할 때, 로컬 백업을 쿼리하고 결합된 피어의 공개 백업에 요청을 확산한 후 답변을 통합합니다.

시작하기(사용자용)

다운로드 – 다운로드 섹션(또는 미러 링크)에서 macOS, Windows, Linux용 데스크톱 설치 프로그램을 다운로드. 설치 후 실행하면 프로젝트 작성자와 자동으로 바인딩됩니다.
휴대폰 페어링 – App Store 또는 Google Play에서 EnvoyGo를 설치하고, 데스크톱 UI에 표시된 QR 코드를 스캔하면 스마트폰에 동기화된 프로필이 생성됩니다.
채팅 및 AI – 소셜 UI(http://localhost:5173, 소스에서 실행 시)를 사용해 대화 시작, 방 생성, 내장형 AI에게 도움 요청.
옵션: 외부 AI – 호환 에이전트(예: hermes serve)를 실행하고 설정 → AI → AI 엔진에서 활성화. 브리지가 메시지를 외부 서비스로 전달합니다.

시작하기(개발자용)

# 리포지토리 클론
git clone https://github.com/allenpeng0705/EnvoyMesh.git
cd EnvoyMesh

# 제공된 세팅 스크립트 실행 – 함께 형제 리포지토리 envoy-harness도 클론
./scripts/setup.sh   # Windows에서는 .\scripts\setup.ps1

# 노드와 웹 UI 시작
npm run node:dev      # P2P 노드
npm run social:dev    # http://localhost:5173 열림

이 리포지토리는 Node ≥ 22.13, pnpm, 그리고 형제 envoy-harness 리포지토리(코딩 에이전트 런타임)가 필요합니다. 데스크톱 빌드는 Tauri를 사용합니다(./scripts/build-desktop.sh).

현재 상태

베타 준비 데스크톱 앱 – GitHub 릴리스에 바이너리가 게시됨.
모바일 클라이언트(EnvoyGo) – iOS 18.6+ 및 Android 공식 스토어에서 이용 가능.
내장형 AI(OpenClaw) 는 기능 완료되어 인프로세스에서 실행. 외부 브리지 지원은 문서화되어 있으며, 3개의 내장 프리셋과 호환됨.
지식 기반 통합(마크다운 에디터, Obsidian 플러그인, 연합 RAG)이 구현됨.
로드맵 항목 – 영상 통화, 더 풍부한 마켓플레이스 기능, 외부 에이전트 어댑터 추가는 가이드북에 기재됨.

누구에게 유용할까?

하드웨어에서 벗어나지 않고도 소셜 네트워크와 AI 어시스턴트를 완전히 통제하고 싶은 개인정보 중심 사용자.
AI 기반 작업 자동화를 갖춘 공유형, 자체 호스팅된 협업 공간이 필요한 팀이나 가족.
커스텀 AI 에이전트 개발 또는 메시 확장(새 지식 기반 플러그인, 대체 외부 에이전트 등)에 관심 있는 개발자.

TL;DR – EnvoyMesh는 안전한 메시징, 개인 지식 백업, 사용자 자신의 암호화된 신원 하에서 플러그인 가능한 AI 에이전트를 통합한 풀스택 자체 호스팅 P2P 플랫폼입니다.