AstronRPA

📋 概述

AstronRPA 是一款企业级机器人流程自动化（RPA）桌面应用。通过可视化设计器，它支持低代码/无代码开发，使用户能够快速构建工作流并自动化桌面软件和网页操作。

Astron Agent 是本项目所支持的原生智能体平台。用户可以直接在 Astron Agent 中调用 RPA 工作流节点，也可以在 AstronRPA 中使用 Agent 工作流，从而实现自动化流程与智能体系统之间的高效协同，赋能更广泛的业务自动化场景。

🎯 为什么选择 AstronRPA？

• 🛠️ 全面的自动化支持：全面覆盖 Windows 桌面应用程序和网页自动化。支持 WPS、Office 等常用办公软件，金蝶、用友等财务及 ERP 系统，以及 IE、Edge、Chrome 等多种浏览器，实现端到端的跨应用自动化。
• 🧩 高度组件化：内置 300 多种原子能力，涵盖 UI 操作、数据处理和系统交互。支持可视化编排和自定义组件扩展，具有高度灵活性和可维护性。
• 🏭 企业级安全与协作：内置卓越中心和团队市场，并配备企业模块。提供终端监控、调度模式、机器人团队共享与协作功能。通过流程安全、权限控制和跨团队协作，构建完整的企业自动化管理生态。
• 👨‍💻 开发者友好体验：低代码、可视化的流程设计与调试环境。通过直观的拖拽方式快速构建自动化流程，降低开发门槛，提升开发效率，使业务用户也能参与自动化创建。
• 🤖 原生智能体赋能：与 Astron Agent 平台深度集成，支持自动化流程与 AI 智能体之间的双向调用，实现能力融合。达成任务推理、决策制定与自动化执行之间的无缝衔接，拓展自动化边界。
• 🌐 多渠道触发集成：支持直接执行、定时任务、调度模式、API 调用和 MCP 服务。灵活的集成能力可快速响应第三方系统集成需求，轻松嵌入复杂业务场景。

🚀 快速开始

系统要求

• 💻 客户端操作系统：Windows 10/11（主要支持）
• 🧠 内存 >= 8 GiB

服务器：使用 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 为默认端口，若修改过配置则相应调整）。
• 若出现 Casdoor 登录页面，则说明 Casdoor 部署成功。
• 如需生产环境部署及安全加固，请参考 部署指南。

客户端：源码部署/二进制部署

环境依赖

工具	版本	说明
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++

具体安装说明及常见问题，请参阅 构建指南。

直接下载（推荐）

下载最新 发布包。

一键构建

1. 准备 Python 环境

   # 准备一个 Python 3.13.x 的安装目录（可以是本地文件夹或系统安装路径）
   # 脚本会复制该目录以创建 python_core
   

2. 运行构建脚本

   # 从项目根目录进行完整构建（引擎 + 前端 + 桌面应用）
   ./build.bat --python-exe "C:\Program Files\Python313\python.exe"
   
   # 或使用默认配置（若 Python 在默认路径下）
   ./build.bat
   
   # 等待完成
   # 控制台显示“Full Build Complete!”即构建成功。
   

   注意：请确保指定的 Python 解释器为纯净安装，不含额外的第三方包，以最小化包体积。

   构建过程包括：

   1. ✅ 检测/复制 Python 环境至 build/python_core
   2. ✅ 安装 RPA 引擎依赖
   3. ✅ 将 Python 核心压缩至 resources/python_core.7z
   4. ✅ 安装前端依赖
   5. ✅ 构建前端 Web 应用
   6. ✅ 构建桌面应用

3. 📦 安装打包好的客户端

⚙️ 安装完成后，请在安装目录下的 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 场景设计。

📦 组件生态

核心组件包

• astronverse.system: 系统操作、进程管理、截图
• astronverse.browser: 浏览器自动化、网页操作
• astronverse.gui: GUI 自动化、鼠标键盘操作
• astronverse.excel: Excel 表格操作、数据处理
• astronverse.vision: 计算机视觉、图像识别
• astronverse.ai: AI 智能服务集成
• astronverse.network: 网络请求、API 调用
• astronverse.email: 邮件收发
• astronverse.docx: Word 文档处理
• astronverse.pdf: PDF 文档操作
• astronverse.encrypt: 加密解密功能

执行框架

• astronverse.actionlib: 原子操作定义与执行
• astronverse.executor: 工作流执行引擎
• astronverse.picker: 工作流元素选择引擎
• astronverse.scheduler: 引擎调度器
• astronverse.trigger: 引擎触发器

共享库

• astronverse.baseline: RPA 框架核心
• astronverse.websocketserver: WebSocket 通信
• astronverse.websocketclient: WebSocket 通信
• astronverse.locator: 元素定位技术

📚 文档

• 📖 用户指南
• 🚀 部署指南
• 📖 API 文档
• 🔧 组件开发指南
• 🐛 故障排除
• 📝 更改日志

🤝 贡献

我们欢迎任何形式的贡献！请查看贡献指南。

开发规范

• ✅ 遵循现有代码风格
• ✅ 添加必要的测试用例
• ✅ 更新相关文档
• ✅ 确保所有检查通过

贡献步骤

1. 🍴 分支仓库
2. 🌿 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 💾 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 🚀 推送到分支 (git push origin feature/AmazingFeature)
5. 📝 打开一个 Pull Request

🌟 星标历史

💖 赞助

📞 获取帮助

• 📧 技术支持: cbg_rpa_ml@iflytek.com
• 💬 社区讨论: GitHub Discussions
• 🐛 问题报告: Issues
• 👥 企业微信工作群:

📄 许可证

本项目遵循开源许可证开放源代码。

---

AstronRPA 快速上手指南

AstronRPA 是一款企业级开源桌面 RPA（机器人流程自动化）应用，支持通过可视化设计器进行低代码/无代码开发，能够快速构建工作流以自动化操作桌面软件和网页。

1. 环境准备

系统要求

• 操作系统：Windows 10/11（客户端主要支持）
• 内存：≥ 8 GiB
• 部署方式：服务端推荐使用 Docker 部署；客户端支持源码编译或直接下载二进制包。

前置依赖

若选择源码编译客户端，需安装以下工具：

工具	版本要求	说明
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++

注意：请确保指定的 Python 解释器为干净安装（无额外第三方包），以减小最终打包体积。

2. 安装步骤

AstronRPA 采用前后端分离架构，需分别部署服务端和客户端。

第一步：部署服务端 (Docker)

推荐使用 Docker Compose 快速启动所有服务。

# 1. 克隆仓库
git clone https://github.com/iflytek/astron-rpa.git
cd astron-rpa

# 2. 进入 docker 目录
cd docker

# 3. 复制环境变量配置文件
cp .env.example .env

# 4. 修改 .env 文件中的 Casdoor 服务配置
# 将 {YOUR_SERVER_IP} 替换为你的服务器 IP 地址
# CASDOOR_EXTERNAL_ENDPOINT="http://{YOUR_SERVER_IP}:8000"

# 5. 启动所有服务
docker compose up -d

# 6. 检查服务状态
docker compose ps

验证部署：

• 访问 http://{YOUR_SERVER_IP}:32742/api/rpa-auth/user/login-check，若返回 {"code":"900001",...} 表示后端正常。
• 访问 http://{YOUR_SERVER_IP}:8000，若看到 Casdoor 登录页表示认证服务正常。

第二步：安装客户端

方案 A：直接下载（推荐）

前往 Release 页面 下载最新版本的安装包并安装。

方案 B：源码一键构建

在项目根目录执行构建脚本：

# 指定 Python 路径进行全量构建 (引擎 + 前端 + 桌面应用)
./build.bat --python-exe "C:\Program Files\Python313\python.exe"

# 若 Python 已在默认路径，可直接运行
./build.bat

当控制台显示 Full Build Complete! 时，构建成功。生成的客户端位于构建输出目录。

第三步：配置连接

安装或构建完成后，需修改客户端配置文件以连接服务端。 编辑安装目录下的 resources/conf.yaml：

# 将 YOUR_SERVER_ADDRESS 替换为实际的服务端 IP
remote_addr: http://YOUR_SERVER_ADDRESS:32742/
skip_engine_start: false

3. 基本使用

1. 启动客户端：运行安装好的 AstronRPA 桌面应用。
2. 登录系统：使用浏览器访问服务端地址注册账号，或在客户端登录界面输入凭证（取决于具体认证配置）。
3. 创建流程：
   • 进入可视化设计器界面。
   • 从左侧组件库拖拽原子能力（如 打开浏览器 、点击元素、 读取 Excel 等）到画布。
   • 配置每个节点的参数。
4. 调试与运行：
   • 点击“调试”按钮单步执行流程。
   • 确认无误后点击“运行”，RPA 机器人将自动执行预设的桌面或网页操作。
5. 高级集成：如需结合 AI 能力，可调用 Astron Agent 平台，实现自然语言触发或智能决策节点。