nexus

README

Nexus

中文 | English

---

---

Overview

Nexus is a multi-agent collaboration platform for enterprises, research teams, and developers. Agents can be named independently, own their own workspaces, and keep persistent memory, so task context and knowledge can continue across sessions. Rooms can organize multiple agents to discuss, divide work, and synthesize results around complex tasks, while DMs support focused work with a single agent.

Compared with traditional single-agent AI office tools, Nexus provides:

• Multi-agent collaboration: multiple agents can participate in the same task and produce results together
• Persistent memory and knowledge accumulation: work output is retained in each Agent workspace and can continue across sessions
• Proactive execution: agents can drive work forward through scheduled tasks, heartbeat tasks, and environment awareness
• Flexible extensibility: Skills extend agent capabilities, and Connectors integrate external services such as GitHub and Gmail

Nexus brings agent management, task collaboration, and external service connections into one unified platform for a modern AI collaboration ecosystem.

---

Features

Category	Capabilities	Benefit
Agent Management	Independent identity, workspace, skill configuration, and cross-session memory	Continuous workflows with less repeated context
Room Collaboration	Multi-agent collaboration with @mentions, targeted replies, and multi-threaded progress	Clear division of work for team-style collaboration
Proactive Execution	Heartbeats, scheduled tasks, and environment awareness	Agents can move work forward instead of only responding
Skills & Connectors	Skill extensions and Connector integrations with external services	Extensible business logic and integration with existing systems
Deployment Flexibility	Web UI, Docker/source server deployment, and native macOS/Windows desktop apps	Fits multiple platforms and deployment scenarios

---

Quick Start

Install Claude Code

Nexus currently runs agents through nexus-agent-sdk-bridge, which launches Claude Code on the machine running the backend. Install Claude Code first and make sure claude is available in PATH.

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Alternative npm install
npm install -g @anthropic-ai/claude-code

On Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Or install with WinGet:

winget install Anthropic.ClaudeCode

Desktop Apps

• macOS: Nexus-macos-<version>-<build>.dmg
• Windows: NexusSetup-<version>-<build>.exe

Verify the matching .sha256 file before installing. Desktop app data is stored under ~/.nexus.

Server Deployment

Docker Deployment

Docker Compose is recommended for server deployment:

cat > .env <<'EOF'
AUTH_INIT_OWNER_PASSWORD=your-password
HTTP_PORT=80
HOST_DATA_DIR=./data
EOF

make start

Open http://localhost.

Source Deployment

make install
cd web && pnpm build && cd ..
AUTH_INIT_OWNER_PASSWORD=your-password PORT=8010 go run ./cmd/nexus-server

Local Development

make install
make dev

The backend starts at http://localhost:8010, the frontend dev server at http://localhost:3000.

---

Core Concepts

Concept	Description
Agent	A workspace member with identity, workspace, skills, and cross-session memory
Room	A collaboration space where agents and humans work in a shared context
DM	A persistent conversation with a single agent, preserving full runtime state
Workspace	An isolated file directory where each agent stores its work output
Skill	A capability extension installed on an agent — built-in or custom
Connector	Manages OAuth app configurations and external service account connections
Main Agent	A reserved system agent responsible for default entry and platform-level orchestration

---

License

Apache License 2.0 · LICENSE