README.zh.md
🤖 首个完整开源的企业级RPA桌面应用
<p align="center"> <a href="https://www.iflyrpa.com">星辰RPA官网</a> · <a href="./BUILD_GUIDE.zh.md">部署文档</a> · <a href="https://www.iflyrpa.com/docs/">使用文档</a> · <a href="./FAQ.zh.md">常见问题</a> </p>English | 简体中文
</div>AstronRPA 是一款企业级机器人流程自动化（RPA）桌面应用。通过可视化设计器支持低代码/无代码开发，用户能快速构建工作流，实现桌面软件和浏览器页面的自动化。
Astron Agent 是本项目原生支持的 Agent 平台，用户可在 Astron Agent 中直接调用 RPA 流程节点，也可在 AstronRPA 中使用 Agent 的工作流，实现自动化流程与智能体系统的高效协同，赋能更广泛的业务自动化场景。
推荐使用 Docker 进行快速部署：
# 克隆项目
git clone https://github.com/iflytek/astron-rpa.git
cd astron-rpa
# 进入 docker 目录
cd docker
# 复制 .env
cp .env.example .env
# 修改 .env 中 Casdoor 的服务配置（8000 为默认端口）
CASDOOR_EXTERNAL_ENDPOINT="http://{YOUR_SERVER_IP}:8000"
# 🚀 启动所有服务
docker compose up -d
# 📊 检查服务状态
docker compose ps
http://{YOUR_SERVER_IP}:32742/api/rpa-auth/user/login-check（32742 为默认端口，如有修改自行变更）{"code":"900001","data":null,"message":"unauthorized"}，则表示部署正确且能正常连通。http://{YOUR_SERVER_IP}:8000（8000 为默认端口，如有修改自行变更）| 工具 | 版本要求 | 说明 |
|---|---|---|
| Node.js | >= 22 | JavaScript 运行时 |
| Python | 3.13.x | RPA 引擎核心 |
| Java | JDK 8+ | 后端服务运行时 |
| pnpm | >= 9 | Node.js 包管理器 |
| UV | 0.8+ | Python 包管理工具 |
| 7-Zip | - | 创建部署归档文件 |
| SWIG | - | 连接 Python 与 C/C++ |
具体的依赖安装方式以及常见问题请参考 构建文档。
使用最新的 Release 安装包
准备 Python 环境
# 准备一个 Python 3.13.x 安装目录（可以是本地文件夹或系统安装路径）
# 脚本会复制该目录来创建 python_core
运行构建脚本
# 在项目根目录执行完整构建（引擎 + 前端 + 桌面应用）
./build.bat --python-exe "C:\Program Files\Python313\python.exe"
# 或使用默认配置（如果 Python 在默认路径）
./build.bat
# 等待操作完成
# 当控制台显示 "Full Build Complete!" 时表示构建成功
注意： 请确保指定的 Python 解释器为纯净安装，未安装额外第三方包，以减小打包体积。
构建流程包含：
build/python_coreresources/python_core.7z📦 安装打包完成的客户端安装包
resources/conf.yaml 中修改服务端地址：```yaml
# 32742 为默认端口，如有修改自行变更
remote_addr: http://YOUR_SERVER_ADDRESS:32742/
skip_engine_start: false
```
本项目采用前后端分离架构，前端基于 Vue 3 + TypeScript 与 Electron 构建桌面应用；后端以 Java Spring Boot 与 Python FastAPI 构建微服务，支撑业务与 AI 能力；引擎层基于 Python，集成 20+ RPA 组件，支持图像识别与 UI 自动化；整体通过 Docker 部署，具备高可观测性与扩展性，专为复杂 RPA 场景设计。
我们欢迎任何形式的贡献！请查看 贡献指南
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)本项目基于 开源协议 开源。
由科大讯飞开发维护
AstronRPA - 让 RPA 开发变得简单而强大！
如果您觉得这个项目对您有帮助，请给我们一个 ⭐ Star！
</div>