agent-weave README

The project's README from github.com/bushm2092-del/agent-weave. As one markdown file: README.md.

AgentWeave

English | 简体中文

AgentWeave is a local-first, spatial workspace for running individual AI agents and coordinating multi-agent teams. It combines a visual canvas, durable conversations, role presets, team orchestration, and an Electron desktop shell in one pnpm monorepo.

AgentWeave is currently under active development. APIs and persisted data formats may change before the first stable release.

Product Preview

Spatial multi-agent canvas

Place agents from different providers on one infinite canvas, keep each conversation independent, and arrange the workspace around the task.

Multiple AI agents arranged on the AgentWeave canvas

Live agent conversations

Work with an agent directly inside a resizable canvas node, including model controls, streamed responses, reasoning, tool calls, and workspace context.

A live Pi agent conversation with tool-call output

Agent Team orchestration

Coordinate a leader and multiple teammates in one team node, while inspecting members, tasks, and activity from the team panel.

An Agent Team with four independently managed members

Reusable role presets

Create persisted roles with provider-specific instructions, then assign them consistently when building new agent teams.

The AgentWeave role preset library

Highlights

Architecture

Package Responsibility
packages/web React 19 application, tldraw canvas, conversation UI, and team management
packages/server Express API, SQLite persistence, SSE streams, acpx integration, and team orchestration
packages/contracts Shared Zod schemas, request/response DTOs, events, and domain types
packages/desktop Electron shell and macOS/Windows packaging

The server communicates with agent runtimes through acpx. Team agents also collaborate through an authenticated stdio MCP bridge. Each team member owns an isolated managed conversation while the Team service coordinates runs, tasks, mailbox intents, spawn approvals, and replayable events.

Requirements

Quick Start

Install dependencies and start the web application and API:

pnpm install
pnpm dev

The web application is available at http://localhost:5173 by default.

To start only one side:

pnpm dev:web
pnpm dev:server

To run the Electron application, including its development web and API servers:

pnpm dev:desktop

Configuration

Copy the server environment example before overriding defaults:

cp packages/server/.env.example packages/server/.env

The server configuration covers the host, port, allowed CORS origins, SQLite database path, acpx state directory, and turn timeout. Desktop production builds use the platform user-data directory by default. Set AGENT_WEAVE_API_ORIGIN before launching the desktop application to connect it to an external API server.

Desktop Builds

Create unpacked application output:

pnpm desktop:pack

Build distributable packages under packages/desktop/release:

pnpm desktop:dist:mac
pnpm desktop:dist:win

The macOS build produces DMG and ZIP artifacts for Intel and Apple Silicon. The Windows build produces an x64 NSIS installer and portable executable.

Main APIs

The API is mounted under /api/v1 and includes:

Conversation and Team event streams support sequence cursors for reconnecting clients. Live content deltas are delivered as transient SSE events, while completed run content is stored as full blocks for efficient reloads.

Roadmap

Quality Checks

Run all repository checks from the project root:

pnpm typecheck
pnpm lint
pnpm test
pnpm build

Documentation

Community

Scan the QR code to join the AgentWeave WeChat group for product updates, usage discussions, and feedback. The invitation QR code is refreshed periodically.

Join the AgentWeave WeChat group

License

No license has been declared yet. Until one is added, all rights are reserved by the repository owner.

agent-weave (bushm2092-del/agent-weave)

Searching Database…

205 ·GitHub
Agent-weave
Что это?AgentWeave — это пространственное рабочее окружение с локальным хранением данных для запуска отдельных ИИ-агентов и координации мультиагентных команд на бесконечном холсте; поддерживаются провайдеры вроде Codex, Claude, OpenCode и Pi.
Это веб-приложение или десктопное?И то и другое: это веб-приложение на React с API на Express, а тот же веб-интерфейс со встроенным API можно упаковать и в десктопное приложение на Electron для macOS и Windows.
Как его запустить?Склонируйте pnpm-монорепозиторий, установите зависимости, затем выполните pnpm dev, чтобы запустить веб-приложение и API вместе (или pnpm dev:web / pnpm dev:server для одной из сторон, pnpm dev:desktop для оболочки Electron).
Что должно быть установлено перед запуском?Нужны Node.js 24 или новее, pnpm 11 (закреплён через packageManager) и провайдер агентов, поддерживаемый вашей локальной установкой acpx.
Готово ли это к повседневному использованию в продакшене?Пока нет — проект открыто находится в активной разработке, и README предупреждает, что API и форматы сохраняемых данных могут ещё измениться до первого стабильного релиза.
Куда попадают мои данные переписки?Переписки, блоки контента, запуски, снимки холста и состояние команд сохраняются локально в SQLite, а не отправляются в удалённый сервис.
Что такое acpx и как агенты подключаются через него?acpx — это среда исполнения, с которой сервер AgentWeave взаимодействует, чтобы управлять каждым провайдером агентов; агенты команд дополнительно сотрудничают через аутентифицированный stdio MCP-мост.
Как именно работают команды агентов (Agent Teams)?Узел команды имеет одного лидера и нескольких участников, у каждого — изолированная переписка, общий контекст рабочего окружения, задачи и сообщения в почтовом ящике; создание новых участников контролируется одобрением.
Могут ли агенты запоминать что-то между сессиями?Общая основа памяти фиксирует повторно применимые знания из завершённой работы агентов, чтобы другие агенты и будущие сессии могли обращаться к прежним решениям и находкам, а не повторять исследование.
What are similar projects?multi-agent-discuss, Agentlas-OS, munder-difflin, ruflo, evenfire, CanvasTTY, turnstone, mission-control
Which topics is it in?sse, electron-app, express, multi-agent-systems, canvas, agent-memory, monorepo, orchestration, agent-orchestration, electron, sqlite, multi-agent
Creator
bushm2092-del
Size
5.8 MB
Stars
205
Updated
CommitSep 03
Age
1mo
Commits · 90 Days