# manus-replica

**Repository Path**: happy_source/manus-replica

## Basic Information

- **Project Name**: manus-replica
- **Description**: manus-replica
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Manus

## README

# Manus Replica

通用 AI Agent 系统 — 基于 Planner + React 架构的智能助手，支持多轮对话、工具调用、文件管理和远程沙箱操作。

## 系统架构

```
┌──────────┐     HTTP/SSE      ┌──────────┐     Docker API    ┌──────────┐
│   UI     │ ◄──────────────►  │   API    │ ◄──────────────►  │ Sandbox  │
│ Next.js  │                   │ FastAPI  │                   │ FastAPI  │
│ :3000    │                   │ :8000    │                   │ :8080    │
└──────────┘                   └──────────┘                   └──────────┘
                                    │
                              ┌─────┼─────┐
                              │     │     │
                           PG      Redis   COS
```

| 子项目 | 说明 | 端口 |
|--------|------|------|
| **ui** | Web 前端，基于 Next.js 16 的实时对话界面 | 3000 |
| **api** | 后端服务，AI Agent 核心，支持 A2A + MCP 协议 | 8000 |
| **sandbox** | Docker 沙箱，提供 Shell 执行、文件操作和进程管理 | 8080 |

## 工作流程

```
用户消息 → PlannerAgent 生成计划（拆解子任务）
         → ReactAgent 逐步执行每个子任务（调用工具）
         → PlannerAgent 更新计划（根据执行结果调整）
         → ReactAgent 汇总结果 → 返回最终回复
```

内置工具：Shell、Browser（Playwright）、File、Search（Bing）、Message、MCP、A2A

## 快速开始

### 环境要求

- Python >= 3.12
- Node.js >= 18
- PostgreSQL + Redis
- Docker（用于沙箱运行环境）

### 启动 Sandbox

```bash
cd sandbox
uv sync
cp .env.example .env
uvicorn app.main:app --reload --lifespan on
```

### 启动 API

```bash
cd api
uv sync
cp .env.example .env
cp config.yaml.example config.yaml
cp alembic.ini.example alembic.ini
# 编辑 .env 和 config.yaml 填写数据库、Redis、LLM 等配置
alembic upgrade head
bash dev.sh
```

### 启动 UI

```bash
cd ui
npm install
npm run dev
```

访问 http://localhost:3000 即可使用。

### Docker 部署

```bash
# API
cd api && docker build -t manus-api .
docker run -d --name manus-api -p 8000:8000 \
  -v /var/run/docker.sock:/var/run/docker.sock:ro manus-api

# Sandbox
cd sandbox && docker compose -f .devops/docker-compose.yml up -d
```

## 技术栈总览

| 层级 | 技术 |
|------|------|
| 前端 | Next.js 16 + React 19 + TypeScript + Tailwind CSS + Shadcn/ui |
| 后端 | FastAPI + Uvicorn + SQLAlchemy + Alembic |
| 数据库 | PostgreSQL + Redis |
| 对象存储 | 腾讯云 COS |
| AI | OpenAI SDK（兼容 DeepSeek 等）+ MCP + A2A |
| 浏览器自动化 | Playwright |
| 容器化 | Docker + Supervisor |
| VNC | noVNC（浏览器内远程控制） |

## 子项目详细文档

- [api/README.md](api/README.md) — API 服务架构、接口文档、数据库迁移
- [ui/README.md](ui/README.md) — 前端组件、页面路由、代码规范
- [sandbox/README.md](sandbox/README.md) — 沙箱 API、Shell 会话、进程管理