# JManus
**Repository Path**: JourWon/JManus
## Basic Information
- **Project Name**: JManus
- **Description**: 🧠 JManus (Spring AI Alibaba)
JManus 是基于 Spring AI Alibaba 构建的 Java 实现 “Manus” 智能体平台，专为高确定性任务、自动规划执行与提示编程设计，目前已在阿里巴巴内部多项应用中使用。
🔄 本仓库为 GitHub 官方仓库的镜像同步版，不定期更新保持一致。
🚀 适合用于源码探索、智能体平台研究与任务自动化学习。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-11-02
- **Last Updated**: 2025-12-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Spring AI Alibaba JManus
[](LICENSE)
[](https://openjdk.java.net/)
[](https://spring.io/projects/spring-boot)
[](https://github.com/alibaba/spring-ai-alibaba/stargazers)
[English](./README.md) | 🌍 **中文**
📚 开发者文档: [Quick Start (EN)](./README-dev-en.md) | [开发者快速入门 (中文)](./README-dev.md)
[关于](#-关于) • [快速开始](#-快速开始) • [如何贡献](#-如何贡献)
## ✨ JManus 简介
JManus 是 Manus 的一个 Java 实现，目前已经在阿里巴巴集团内的很多应用都有使用，主要用于处理需要有一定确定性要求的探索性任务，比如，快速从海量数据中找到数据并转换成数据库内的一行数据，或者分析日志并给出告警等。
JManus 也提供了 http 的服务调用能力，适合被集成到既有的项目中。具体可以见[开发者快速入门 (中文)](./README-dev.md)
## 🎯 JManus 的产品特性
### 🤖 **纯 Java 的 Manus 实现**：
纯粹的 Java 多智能体协作实现，提供了完整的 http 调用接口，适合 Java 开发者做二次集成。
### 🛠️ **Func-Agent 模式**：
精确控制每一步执行细节，提供极高的执行确定性并完成复杂的重复流程和功能。具体可以见 [JManus 案例集-Func-Agent 案例](https://github.com/talk-flow/public-usecase/blob/main/chn/query-plan.md)。
### 🔗 **MCP 集成**：
原生支持模型上下文协议（Model Context Protocol），实现与外部服务和工具的无缝集成。
## 🚀 快速开始
在 5 分钟内启动并运行 JManus：
### 先决条件
- 🌐 **DashScope API 密钥** (或替代的 AI 模型提供商)
- ☕ **Java 17+** (用于运行 JAR 文件或源码运行)
### 方式一：使用 GitHub Release (推荐)
#### 📦 下载并运行 JAR 文件
```bash
# 下载最新版本的 JAR 文件
wget https://github.com/spring-ai-alibaba/JManus/releases/latest/download/jmanus.jar
# 或者使用 curl
curl -L -o jmanus.jar https://github.com/spring-ai-alibaba/JManus/releases/latest/download/jmanus.jar
# 运行 JAR 文件
java -jar jmanus.jar
```
> 💡 **手动下载**: 您也可以直接访问 [JManus Releases 页面](https://github.com/spring-ai-alibaba/JManus/releases) 手动下载最新版本的 JAR 文件。
#### 🌐 访问应用
应用启动后，在浏览器中访问 `http://localhost:18080`。
> 💡 **引导式设置**: 应用启动后会自动显示引导页面。在第一个页面选择中英文语言，然后在第二个页面输入您刚才申请的 DashScope API 密钥即可完成配置。
🎉 **恭喜!** 您的多 Agent 系统现已快速启动完成。 你可以访问https://github.com/talk-flow/public-usecase 去做一些我们认为比较有效的实践。
---
### 方式二：从源码运行 (次选方案)
#### 1. 克隆并导航
```bash
git clone https://github.com/spring-ai-alibaba/JManus.git
cd JManus
```
#### 2. 数据库配置（可选）
> 💡 **获取您的 DashScope API 密钥**: 访问 [阿里云百炼控制台](https://bailian.console.aliyun.com/?tab=model#/api-key) 获取免费 API 密钥。
>
> **使用其他提供商?** 在 `src/main/resources/application.yml` 中更新配置，以使用您偏好的 AI 模型平台。
JManus 支持 H2（默认）、MySQL 以及 PostgreSQL 数据库。
**如何使用 MySQL/PostgreSQL**
1. **配置数据库连接**：
在 `src/main/resources/`下的 application-mysql.yml/application-postgres.yml 中更新数据库配置和 jpa 方言：
```yaml
spring:
datasource:
url: your_url
username: your_username
password: your_password
jpa:
database-platform: org.hibernate.dialect.MySQLDialect/PostgreSQLDialect
```
2. **激活 MySQL/PostgreSQL 配置**：
在 `src/main/resources/application.yml` 中更新配置：
```yaml
spring:
...
profiles:
active: mysql/postgres
```
> 💡 **注意**：应用程序将在首次启动时自动创建所需的表，使用 JPA 的 `ddl-auto: update` 配置。
#### 3. 访问您的多 Agent 仪表盘
在您的浏览器中访问 `http://localhost:18080`。
🎉 **恭喜!** 您的多 Agent 系统现已上线并准备就绪。 你可以访问https://github.com/talk-flow/public-usecase 去做一些我们认为比较有效的实践。
## 稳定版本的 Release
如果你想要之前的稳定版本，可以在这里找到：
[稳定 release 版](https://github.com/spring-ai-alibaba/JManus/releases)
## 🤝 如何贡献
我们热烈欢迎来自开发者社区的贡献！以下是您可以产生影响的方式：
### 贡献机会
您可以在我们的 [项目看板](https://github.com/orgs/spring-ai-alibaba/projects/1) 上找到可用的任务。
- 🐛 **报告 Bug**: [提交详细的问题报告](https://github.com/spring-ai-alibaba/JManus/issues)
- 💡 **功能请求**: [提出创新的增强建议](https://github.com/spring-ai-alibaba/JManus/issues)
- 📝 **文档**: 帮助我们提高文档的清晰度和完整性
- 🔧 **代码贡献**: [提交包含您改进的拉取请求](https://github.com/spring-ai-alibaba/JManus/pulls)
### 开发环境设置
```bash
# Fork 并克隆仓库
git clone git@github.com:spring-ai-alibaba/JManus.git
cd JManus
# 安装项目依赖
mvn clean install
# 应用代码格式化标准
mvn spotless:apply
# 启动开发服务器
mvn spring-boot:run
```
### 开发指南
- 遵循现有的代码风格和约定
- 为新功能编写全面的测试
- 为任何 API 变更更新文档
- 在提交 PR 前确保所有测试都通过
---
**由 Spring AI Alibaba 团队用心打造 ❤️**
⭐ 如果 JManus 加速了您的开发之旅，请在 **GitHub 上给我们点亮一颗星**！
## 交流讨论
点击这个链接加入钉钉群讨论：[钉群链接](https://qr.dingtalk.com/action/joingroup?code=v1,k1,PBuFX00snERuKcnnG4YAPK52FOXwAkLYlulUUD9KiRo=&_dt_no_comment=1&origin=11)