astron-rpa README

The project's README from github.com/iflytek/astron-rpa. As one markdown file: README.md.

AstronRPA

AstronRPA Logo

🤖 Pioneering Open-Source Enterprise RPA Desktop Application

iflytek%2Fastron-rpa | Trendshift

Astron RPA Official Site · Deployment Guide · User Documentation · FAQ

License Version Python GitHub Stars

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?

🚀 Quick Start

System Requirements

Server: Deploy with Docker

Recommended for quick deployment:

# 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

# Modify casdoor service configuration in .env (8000 is the default port)
CASDOOR_EXTERNAL_ENDPOINT="http://{YOUR_SERVER_IP}:8000"

# 🚀 Start all services
docker compose up -d

# 📊 Check service status
docker compose ps

Client: Source Deployment/Binary Deployment

Environment Dependencies

Tool Version Description
Node.js >= 22 JavaScript runtime
Python 3.13.x RPA engine core
Java JDK 8+ Backend runtime
pnpm >= 9 Node.js package manager
UV 0.8+ Python package management tool
7-Zip - Create deployment archives
SWIG - Connect Python with C/C++

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

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
# 32742 is the default port; change it if you modified the configuration
remote_addr: http://YOUR_SERVER_ADDRESS:32742/
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.

Architecture Overview

📦 Component Ecosystem

Core Component Packages

Execution Framework

Shared Libraries

📚 Documentation

🤝 Contributing

We welcome any form of contribution! Please check Contributing Guide

Development Guidelines

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.

Star History Chart

💖 Sponsorship

GitHub Sponsors Open Collective

📞 Getting Help

WeChat Work Group

📄 License

This project is open source under the Open Source License.

Developed and maintained by iFlytek

Follow Star Fork Watch

AstronRPA - Making RPA development simple and powerful!

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

astron-rpa (iflytek/astron-rpa)

Searching Database…

5.3K ·GitHub
Astron-rpa
What is this?AstronRPA is an open-source, enterprise-grade Robotic Process Automation (RPA) desktop application with a visual designer that lets you build low-code/no-code workflows to automate desktop software and web pages, with native integration into iFlytek's Astron Agent platform.
Is this just a desktop app, or is there a server component too?Both: a Windows desktop client built with Vue 3, TypeScript and Electron for designing/running workflows, plus a backend built with Java Spring Boot and Python FastAPI microservices (deployed via Docker) that handles orchestration and AI/Agent capabilities.
How do I get it running?Deploy the server side with Docker for quick setup, then install the client either by downloading the latest pre-built release package or by running the one-click build script from source.
Does the client run on macOS or Linux too?No, the client only officially supports Windows 10/11 and needs at least 8 GiB of RAM; cross-platform desktop support isn't mentioned.
Is this built for individual users or enterprise teams?Both — it targets individuals and enterprises, with enterprise-grade features like an excellence center, team marketplace, terminal monitoring, scheduling modes, and robot-team sharing for cross-team collaboration.
What is Astron Agent and how does it connect to AstronRPA?Astron Agent is iFlytek's native AI agent platform. AstronRPA integrates with it bidirectionally, so RPA workflow nodes can be called from Agent flows and Agent workflows can be used inside AstronRPA, blending automation with AI decision-making.
Can workflows be triggered by something other than clicking run?Yes, workflows support direct execution, scheduled tasks, scheduling modes, API calls, and MCP services as trigger channels, making it easy to embed RPA into external systems.
Why would I use this instead of a generic automation script?AstronRPA packages 300+ ready-made atomic actions, a visual low-code designer, and enterprise collaboration/security tooling, so non-developers can assemble cross-application workflows (desktop + web) without scripting everything from scratch.
What are similar projects?astron-agent, skyvern, kestra, evenfire, JeecgBoot, holaOS, airbyte, maxun
Which topics is it in?on-premise, data-privacy, rpa, gui-automation, spring-boot, low-code, no-code, fastapi, email, microservices, enterprise, workflow-automation
Creator
iflytek
Size
200.1 MB
Stars
5.3K
Updated
CommitOct 16Releasev1.1.6Feb 25
Age
1y
Commits · 90 Days