AI Manus

English | 中文 | 官方网站 | 文档

AI Manus 是一个通用的 AI Agent 系统，支持在沙箱环境中运行各种工具和操作。

快来使用 AI Manus 打造属于你自己的 Agent 吧！

👏 加入 QQ 群 (1005477581)

❤️ 喜欢 AI Manus？请点个 Star 🌟 或通过赞助来支持开发！

🚀 体验 Demo

📝 博客：使用 WebUI 和沙箱重构 Manus

功能演示

基础功能

https://github.com/user-attachments/assets/37060a09-c647-4bcb-920c-959f7fa73ebe

浏览器使用

任务：获取最新的 LLM 论文

代码使用

任务：编写一个复杂的 Python 示例

核心特性

部署：最简部署仅需一个 LLM 服务，不依赖其他外部服务。
工具：支持终端、浏览器、文件操作、网页搜索及消息工具，具备实时查看和接管能力，并支持集成外部 MCP 工具。
沙箱：每个任务都被分配一个在本地 Docker 环境中运行的独立沙箱。
任务会话：通过 MongoDB/Redis 管理会话历史，支持后台任务处理。
对话管理：支持停止和中断任务，支持文件上传和下载。
多语言：支持中英文双语。
身份验证：支持用户登录及权限验证。

开发路线图

工具：支持部署（Deploy）与暴露（Expose）功能。
沙箱：支持移动端和 Windows 电脑访问。
部署：支持 K8s 和 Docker Swarm 多集群部署。

总体设计

当用户发起对话时：

Web 端向服务端发送创建 Agent 的请求，服务端通过 /var/run/docker.sock 创建一个沙箱并返回会话 ID。
沙箱是一个 Ubuntu Docker 环境，其中启动了 Chrome 浏览器及用于文件/Shell 操作的 API 服务。
Web 端将用户消息发送至该会话 ID，服务端接收到消息后将其转发给 PlanAct Agent 进行处理。
在处理过程中，PlanAct Agent 会调用相关工具来完成任务。
Agent 处理过程中产生的所有事件都会通过 SSE 返回给 Web 端。

当用户使用浏览器工具时：

浏览器：
1. 沙箱内的无头浏览器（headless browser）通过 xvfb 和 x11vnc 启动 VNC 服务，并使用 websockify 将 VNC 转换为 WebSocket。
2. Web 端的 NoVNC 组件通过服务端的 Websocket 转发连接到沙箱，从而实现浏览器界面的查看与交互。
其他工具：其他工具的工作原理与之类似。

环境要求

本项目主要依赖 Docker 进行开发和部署，要求安装较新版本的 Docker：

Docker 20.10+
Docker Compose

模型能力要求：

支持 LangChain Chat Model 提供商（默认为 openai）
支持 Function Call（函数调用）
支持 Json 格式输出

推荐使用 Deepseek 或 GPT 系列模型。

部署指南

建议使用 Docker Compose 进行部署：

services:
  frontend:
    image: simpleyyt/manus-frontend
    ports:
      - "5173:80"
    depends_on:
      - backend
    restart: unless-stopped
    networks:
      - manus-network
    environment:
      - BACKEND_URL=http://backend:8000

  backend:
    image: simpleyyt/manus-backend
    depends_on:
      - sandbox
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      #- ./mcp.json:/etc/mcp.json # 挂载 MCP servers 目录
    networks:
      - manus-network
    environment:
      # OpenAI API 基地址
      - API_BASE=https://api.openai.com/v1
      # OpenAI API key，请替换为您自己的
      - API_KEY=sk-xxxx
      # LLM 模型名称
      - MODEL_NAME=gpt-4o
      # LLM 模型提供商
      - MODEL_PROVIDER=openai
      # LLM temperature 参数，控制随机性
      - TEMPERATURE=0.7
      # LLM 响应的最大 tokens
      - MAX_TOKENS=2000

      # MongoDB 连接 URI
      #- MONGODB_URI=mongodb://mongodb:27017
      # MongoDB 数据库名称
      #- MONGODB_DATABASE=manus
      # MongoDB 用户名 (可选)
      #- MONGODB_USERNAME=
      # MongoDB 密码 (可选)

Simpleyyt/ai-manus