AstronRPA

🤖 Pioneering Open-Source Enterprise RPA Desktop Application

English | 简体中文

📋 Overview

AstronRPA is an enterprise-grade Robotic Process Automation (RPA) desktop application. Through a visual designer, it supports low-code/no-code development, enabling users to rapidly build workflows and automate desktop software and web pages.

Astron Agent is the native Agent platform supported by this project. Users can directly call RPA workflow nodes in Astron Agent, and also use Agent workflows in AstronRPA, achieving efficient collaboration between automation processes and intelligent agent systems, empowering broader business automation scenarios.

🎯 Why Choose AstronRPA?

• 🛠️ Comprehensive Automation Support: Comprehensive coverage of Windows desktop applications and web page automation. Supports common office software like WPS and Office, financial and ERP systems like Kingdee and YonYou, and various browsers like IE, Edge, and Chrome, enabling end-to-end cross-application automation.
• 🧩 Highly Component-based: 300+ pre-built atomic capabilities covering UI operations, data processing, and system interactions. Supports visual orchestration and custom component extensions with high flexibility and maintainability.
• 🏭 Enterprise-grade Security & Collaboration: Built-in excellence center and team marketplace with enterprise modules. Provides terminal monitoring, scheduling modes, robot team sharing and collaborative functions. Build a complete enterprise automation management ecosystem with process security, permission control, and cross-team collaboration.
• 👨‍💻 Developer-friendly Experience: Low-code, visual process design and debugging environment. Quickly build automation workflows through intuitive drag-and-drop methods, reducing development barriers, improving development efficiency, and enabling business users to participate in automation creation.
• 🤖 Native Agent Empowerment: Deep integration with Astron Agent platform supporting bi-directional calls between automation processes and AI agents with capability fusion. Achieve seamless connection between task reasoning, decision making, and automated execution, expanding automation boundaries.
• 🌐 Multi-channel Trigger Integration: Supports direct execution, scheduled tasks, scheduling modes, API calls, and MCP services. Flexible integration capabilities to quickly respond to third-party system integration needs and easily embed in complex business scenarios.

🚀 Quick Start

System Requirements

• 💻 Client Operating System: Windows 10/11 (primary support)
• 🧠 RAM >= 8 GiB

Server: Deploy with Docker

Recommended for quick deployment:

For self-hosting, prepare your own server and domain, add gateway/authentication DNS records at the authoritative DNS provider, and obtain a certificate covering both names. The deployer maintains DNS, private keys, public ports, and renewals. See DNS and HTTPS setup before running the commands below; replace all example.com names with your own.

# Clone the repository
git clone https://github.com/iflytek/astron-rpa.git
cd astron-rpa

# Enter docker directory
cd docker

# Copy .env
cp .env.example .env

# Configure the public HTTPS names in .env
RPA_SERVER_NAME="rpa.example.com"
CASDOOR_SERVER_NAME="auth.example.com"
RPA_HTTPS_REDIRECT_AUTHORITY="rpa.example.com"
CASDOOR_HTTPS_REDIRECT_AUTHORITY="auth.example.com:8443"
CASDOOR_EXTERNAL_ENDPOINT="https://auth.example.com:8443"

# Copy a certificate covering both names and its private key
# to docker/certs/tls.crt and docker/certs/tls.key

# 🚀 Start all services
# Initialize independent Casdoor credentials (see docker/HTTPS_DEPLOYMENT.md 1.3)
docker compose up -d mysql casdoor
# Wait for Casdoor initialization
python3 scripts/sync-casdoor-credentials.py
docker compose up -d

# 📊 Check service status
docker compose ps

• After all services have started, open your browser and go to: https://rpa.example.com/api/rpa-auth/user/login-check.
• If you see {"code":"900001","data":null,"message":"unauthorized"}, it means the deployment is correct and the connection is working properly.
• Open your browser and go to: https://auth.example.com:8443.
• If you see the Casdoor login page, it means Casdoor is deployed correctly.
• For production deployment and security hardening, refer to the Deployment Guide.

Client: Source Deployment/Binary Deployment

Environment Dependencies

For specific installation instructions and common issues, refer to Build Guide.

Direct Download (Recommended)

Download the latest Release Package

One-Click Build

1. Prepare Python Environment

   # Prepare a Python 3.13.x installation directory (can be a local folder or system installation path)
   # The script will copy this directory to create python_core
   

2. Run Build Script

   # Full build (engine + frontend + desktop app) from project root directory
   ./build.bat --python-exe "C:\Program Files\Python313\python.exe"
   
   # Or use default configuration (if Python is in default path)
   ./build.bat
   
   # Wait for completion
   # Build successful when console displays "Full Build Complete!"
   

   Note: Please ensure the specified Python interpreter is a clean installation without additional third-party packages to minimize package size.

   Build process includes:

   1. ✅ Detect/copy Python environment to build/python_core
   2. ✅ Install RPA engine dependencies
   3. ✅ Compress Python core to resources/python_core.7z
   4. ✅ Install frontend dependencies
   5. ✅ Build frontend web application
   6. ✅ Build desktop application

3. 📦 Install the packaged client

⚙️ After installation, modify the server address in resources/conf.yaml in the installation directory:

```yaml
remote_addr: https://rpa.example.com/
skip_engine_start: false
```

🏗️ Architecture Overview

The project adopts a frontend-backend separation architecture. The frontend is built with Vue 3 + TypeScript and Electron for desktop applications; the backend uses Java Spring Boot and Python FastAPI to build microservices supporting business and AI capabilities. The engine layer is based on Python, integrating 20+ RPA components with support for image recognition and UI automation. The entire system is deployed via Docker with high observability and scalability, designed for complex RPA scenarios.

📦 Component Ecosystem

Core Component Packages

• astronverse.system: System operations, process management, screenshots
• astronverse.browser: Browser automation, web page operations
• astronverse.gui: GUI automation, mouse and keyboard operations
• astronverse.excel: Excel spreadsheet operations, data processing
• astronverse.vision: Computer vision, image recognition
• astronverse.ai: AI intelligent service integration
• astronverse.network: Network requests, API calls
• astronverse.email: Email sending and receiving
• astronverse.docx: Word document processing
• astronverse.pdf: PDF document operations
• astronverse.encrypt: Encryption and decryption functions

Execution Framework

• astronverse.actionlib: Atomic operation definition and execution
• astronverse.executor: Workflow execution engine
• astronverse.picker: Workflow element picker engine
• astronverse.scheduler: Engine scheduler
• astronverse.trigger: Engine trigger

Shared Libraries

• astronverse.baseline: RPA framework core
• astronverse.websocketserver: WebSocket communication
• astronverse.websocketclient: WebSocket communication
• astronverse.locator: Element locating technology

📚 Documentation

• 📖 User Guide
• 🚀 Deployment Guide
• 📖 API Documentation
• 🔧 Component Development Guide
• 🐛 Troubleshooting
• 📝 Changelog

🤝 Contributing

We welcome any form of contribution! Please check Contributing Guide

Development Guidelines

• ✅ Follow existing code style
• ✅ Add necessary test cases
• ✅ Update relevant documentation
• ✅ Ensure all checks pass

Contributing Steps

1. 🍴 Fork the repository
2. 🌿 Create your feature branch (git checkout -b feature/AmazingFeature)
3. 💾 Commit your changes (git commit -m 'Add some AmazingFeature')
4. 🚀 Push to the branch (git push origin feature/AmazingFeature)
5. 📝 Open a Pull Request

🌟 Star History

If AstronRPA saves you time, consider giving it a ⭐ — it is the simplest way to support the project and helps other automation builders discover it.

💖 Sponsorship

📞 Getting Help

• 📧 Technical Support: cbg_rpa_ml@iflytek.com
• 💬 Community Discussion: GitHub Discussions
• 🐛 Bug Reports: Issues
• 👥 WeChat Work Group:

📄 License

This project is open source under the Open Source License.

Developed and maintained by iFlytek

AstronRPA - Making RPA development simple and powerful!

If you find this project helpful, please give us a ⭐ Star!