iflytek

Open Source

astron-agent

<div align="center"> [![Astron Agent Logo](./logo.svg)](https://iflytek.github.io/astron-agent/) [![Astron_Readme](./docs/imgs/Astron_Readme.png)](https://agent.xfyun.cn) [![License](https://img.shields.io/badge/license-apache2.0-blue.svg)](LICENSE) [![GitHub Stars](https://img.shields.io/github/stars/iflytek/astron-agent?style=social)](https://github.com/iflytek/astron-agent/stargazers) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/iflytek/astron-agent) English | [简体中文](docs/README-zh.md) </div> ## 🔭 What is Astron Agent Astron Agent is an **enterprise-grade, commercial-friendly** Agentic Workflow development platform that integrates AI workflow orchestration, model management, AI and MCP tool integration, RPA automation, and team collaboration features. The platform supports **high-availability** deployment, enabling organizations to rapidly build **scalable, production-ready** intelligent agent applications and establish their AI foundation for the future. ### Why Choose Astron Agent? - **Stable and Reliable**: Built on the same core technology as the iFLYTEK Astron Agent Platform, providing enterprise-grade reliability with a fully available high-availability version open source. - **Cross-System Integration**: Natively integrates intelligent RPA, efficiently connecting internal and external enterprise systems, enabling seamless interaction between Agents and enterprise systems. - **Enterprise-Grade Open Ecosystem**: Deeply compatible with various industry models and tools, supporting custom extensions and flexibly adapting to diverse enterprise scenarios. - **Business-Friendly**: Released under the Apache 2.0 License, with no commercial restrictions, allowing free commercial use. ### Key Features - **Enterprise-Grade High Availability:** Full-stack capabilities for development, building, optimization, and management. Supports one-click deployment with strong reliability. - **Intelligent RPA Integration:** Enables cross-system process automation, empowering Agents with controllable execution to achieve a complete loop “from decision to action.” - **Ready-to-Use Tool Ecosystem:** Integrates massive AI capabilities and tools from the [iFLYTEK Open Platform](https://www.xfyun.cn), validated by millions of developers, supporting plug-and-play integration without extra development. - **Flexible Large Model Support:** Offers diverse access methods, from rapid API-based model access and validation to one-click deployment of enterprise-level MaaS (Model as a Service) on-premises clusters, meeting needs of all scales. ## 🤝 [Adopters](https://iflytek.github.io/astron-agent/cases/) <div align="center"> <img src="./docs/cases/imgs/donghua.png" alt="东华软件" height="56" />     <img src="./docs/cases/imgs/chinatelecom.png" alt="中国电信" height="56" />     <img src="./docs/cases/imgs/yunsuan.jpg" alt="云算数字科技" height="56" />     <img src="./docs/cases/imgs/xiaoqu.png" alt="小趣科技" height="56" />     <img src="./docs/cases/imgs/shandongyungu.png" alt="山东云谷" height="56" /> <br/><br/> <img src="./docs/cases/imgs/guangwu.jpg" alt="广物互联" height="56" />     <img src="./docs/cases/imgs/yugou.jpg" alt="北京榆构" height="56" />     <img src="./docs/cases/imgs/fiberhome.png" alt="烽火通信" height="56" />     <img src="./docs/cases/imgs/foxit.jpg" alt="厦门福昕中数" height="56" />   <img src="./docs/cases/imgs/xiangyang-dongsheng.png" alt="襄阳东昇" height="28" /> </div> ## 📰 News ### 🔄 Ongoing ### 📅 Past - **[Astron Hackathon @ 2025 iFLYTEK Global 1024 Developer Festival](https://luma.com/9zmbc6xb)** 🎤 <a href="https://github.com/mklong"><img src="https://github.com/mklong.png" width="20" align="center" /> @mklong</a> - **[Astron Agent Zhengzhou Meetup](https://github.com/iflytek/astron-agent/discussions/672)** 🎤 <a href="https://github.com/lyj715824"><img src="https://github.com/lyj715824.png" width="20" align="center" /> @lyj715824</a> <a href="https://github.com/wowo-zZ"><img src="https://github.com/wowo-zZ.png" width="20" align="center" /> @wowo-zZ</a> - **[Astron on Campus @ Zhejiang University of Finance and Economics](https://mp.weixin.qq.com/s/oim_Z0ckgpFwf5jOskoJuA)** 🎤 <a href="https://github.com/lyj715824"><img src="https://github.com/lyj715824.png" width="20" align="center" /> @lyj715824</a> - **[Astron Agent & RPA · Qingdao Meetup Brings Agentic AI!](https://github.com/iflytek/astron-agent/discussions/740)** 🎤 <a href="https://github.com/vsxd"><img src="https://github.com/vsxd.png" width="20" align="center" /> @vsxd</a> <a href="https://github.com/doctorbruce"><img src="https://github.com/doctorbruce.png" width="20" align="center" /> @doctorbruce</a> <a href="https://github.com/MaxwellJean"><img src="https://github.com/MaxwellJean.png" width="20" align="center" /> @MaxwellJean</a> - **[Astron Training Camp · Cohort #1](https://www.aidaxue.com/astronCamp)** 🎤 <a href="https://github.com/lyj715824"><img src="https://github.com/lyj715824.png" width="20" align="center" /> @lyj715824</a> <a href="https://github.com/Thomas1024-Astron"><img src="https://github.com/Thomas1024-Astron.png" width="20" align="center" /> @Thomas1024-Astron</a> <a href="https://github.com/abelzha"><img src="https://github.com/abelzha.png" width="20" align="center" /> @abelzha</a> - **[Astron Talk @ Chongqing Mini Tech Fest](https://mp.weixin.qq.com/s/HROf1zZpkPVDSsCQrv2jRg)** 🎤 <a href="https://github.com/lyj715824"><img src="https://github.com/lyj715824.png" width="20" align="center" /> @lyj715824</a> - **[Astron Agent @ MWC Barcelona 2026](https://www.iflytek.com/en/news-events/mwc2026.html)** - **[Astron Agent & RPA · Hefei Meetup](https://mp.weixin.qq.com/s/tDJaoOLUrjBlgMLDurvHCw)** 🎤 <a href="https://github.com/lyj715824"><img src="https://github.com/lyj715824.png" width="20" align="center" /> @lyj715824</a> <a href="https://github.com/doctorbruce"><img src="https://github.com/doctorbruce.png" width="20" align="center" /> @doctorbruce</a> - **[Astron Industrial Intelligence Hackathon](https://awesome-astron-workflow.dev/activities/astron-industrial-intelligence-hackathon)** 🎤 <a href="https://github.com/lyj715824"><img src="https://github.com/lyj715824.png" width="20" align="center" /> @lyj715824</a> <a href="https://github.com/horizon220222"><img src="https://github.com/horizon220222.png" width="20" align="center" /> @horizon220222</a> ## 🚀 Quick Start We offer two deployment methods to meet different scenarios: ### Option 1: Docker Compose (Recommended for Quick Start) ```bash # Clone the repository git clone https://github.com/iflytek/astron-agent.git # Navigate to the Docker deployment directory cd docker/astronAgent # Copy environment configuration cp .env.example .env # Configure environment variables vim .env ``` For environment variable configuration, please refer to the documentation:[DEPLOYMENT_GUIDE_WITH_AUTH.md](https://github.com/iflytek/astron-agent/blob/main/docs/DEPLOYMENT_GUIDE_WITH_AUTH.md#step-2-configure-astronagent-environment-variables) ```bash # Start all services (including Casdoor) docker compose -f docker-compose-with-auth.yaml up -d ``` #### 📊 Service Access Addresses After startup, you can access the services at the following addresses: **Authentication Service** - **Casdoor Admin Interface**: http://localhost:8000 **AstronAgent** - **Application Frontend (nginx proxy)**: http://localhost/ **Note** - Default Casdoor login credentials: username: `admin`, password: `123` ### Option 2: Helm (For Kubernetes Environments) > 🚧 **Note**: Helm charts are currently under development. Stay tuned for updates! ```bash # Coming soon # helm repo add astron-agent https://iflytek.github.io/astron-agent # helm install astron-agent astron-agent/astron-agent ``` --- > 📖 For complete deployment instructions and configuration details, see [Deployment Guide](docs/DEPLOYMENT_GUIDE_WITH_AUTH.md) ## 📖 Using Astron Cloud **Try Astron**：Astron Cloud provides a ready-to-use environment for creating and managing Agents. Get quick access at [https://agent.xfyun.cn](https://agent.xfyun.cn). **Using Guide**：For detailed usage instructions, please refer to [Quick Start Guide](https://www.xfyun.cn/doc/spark/Agent03-%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97.html). ## 📚 Documentation - [🚀 Deployment Guide](docs/DEPLOYMENT_GUIDE.md) - [🔧 Configuration](docs/CONFIGURATION.md) - [🚀 Quick Start](https://www.xfyun.cn/doc/spark/Agent02-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.html) - [📘 Development Guide](https://www.xfyun.cn/doc/spark/Agent03-%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97.html#_1-%E6%8C%87%E4%BB%A4%E5%9E%8B%E6%99%BA%E8%83%BD%E4%BD%93%E5%BC%80%E5%8F%91) - [📖 Tutorial](https://scn5s6198j3j.feishu.cn/wiki/VefnwvPbridJBikCUb1cYXO9nYb) - [💡 Best Practices](https://www.xfyun.cn/doc/spark/AgentNew-%E6%8A%80%E6%9C%AF%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B.html) - [📱 Use Cases](https://www.xfyun.cn/doc/spark/Agent05-%E5%BA%94%E7%94%A8%E6%A1%88%E4%BE%8B.html) - [❓ FAQ](https://www.xfyun.cn/doc/spark/Agent06-FAQ.html) - [🌐 Open Source Workflows](https://awesome-astron-workflow.dev/#workflows) ## 🤝 Contributing We welcome contributions of all kinds! Please see our [Contributing Guide](CONTRIBUTING.md) ## 🌟 Star History <div align="center"> <img src="https://api.star-history.com/svg?repos=iflytek/astron-agent&type=Date" alt="Star History Chart" width="600"> </div> ## 📞 Support - 💬 Community Discussion: [GitHub Discussions](https://github.com/iflytek/astron-agent/discussions) - 🐛 Bug Reports: [Issues](https://github.com/iflytek/astron-agent/issues) - [![Discord](https://img.shields.io/badge/Discord-5865F2?style=flat&logo=discord&logoColor=white)](https://discord.gg/YgG2v9NEMH) - 👥 WeChat Work Group: <div align="center"> <img src="./docs/imgs/WeCom_Group.png" alt="WeChat Work Group" width="300"> </div> ## 📄 Open Source License This project is licensed under the [Apache 2.0 License](LICENSE), allowing free use, modification, distribution, and commercial use without any restrictions.

AI Agents Workflow Automation

8.5K Github Stars

Open Source

astron-rpa

# AstronRPA <div align="center"> ![AstronRPA Logo](./docs/images/icon_128px.png) **🤖 Pioneering Open-Source Enterprise RPA Desktop Application** <p align="center"> <a href="https://www.iflyrpa.com">Astron RPA Official Site</a> · <a href="./BUILD_GUIDE.md">Deployment Guide</a> · <a href="https://www.iflyrpa.com/docs/">User Documentation</a> · <a href="./FAQ.md">FAQ</a> </p> [![License](https://img.shields.io/badge/license-Open%20Source-blue.svg)](LICENSE) [![Version](https://img.shields.io/github/v/release/iflytek/astron-rpa)](https://github.com/iflytek/astron-rpa/releases) [![Python](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/) [![GitHub Stars](https://img.shields.io/github/stars/iflytek/astron-rpa?style=social)](https://github.com/iflytek/astron-rpa/stargazers) English | [简体中文](README.zh.md) </div> ## 📋 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](https://github.com/iflytek/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: ```bash # 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 ``` - After all services have started, open your browser and go to: `http://{YOUR_SERVER_IP}:32742/api/rpa-auth/user/login-check` (32742 is the default port; change it if you modified the configuration). - 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: `http://{YOUR_SERVER_IP}:8000` (8000 is the default port; change it if you modified the configuration). - If you see the Casdoor login page, it means Casdoor is deployed correctly. - For production deployment and security hardening, refer to the [Deployment Guide](./docker/QUICK_START.md). ### **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](./BUILD_GUIDE.md). #### Direct Download (Recommended) Download the latest [Release Package](https://github.com/iflytek/astron-rpa/releases) #### One-Click Build 1. **Prepare Python Environment** ```bash # 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** ```bash # 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](./docs/images/Structure.png "Architecture Overview") ## 📦 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](https://www.iflyrpa.com/docs/) - [🚀 Deployment Guide](docker/QUICK_START.md) - [📖 API Documentation](backend/openapi-service/api.yaml) - [🔧 Component Development Guide](engine/components/) - [🐛 Troubleshooting](docs/TROUBLESHOOTING.md) - [📝 Changelog](CHANGELOG.md) ## 🤝 Contributing We welcome any form of contribution! Please check [Contributing Guide](CONTRIBUTING.md) ### 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 <div align="center"> <img src="https://api.star-history.com/svg?repos=iflytek/astron-rpa&type=Date" alt="Star History Chart" width="600"> </div> ## 💖 Sponsorship <div align="center"> <a href="https://github.com/sponsors/iflytek"> <img src="https://img.shields.io/badge/Sponsor-GitHub%20Sponsors-pink?style=for-the-badge&logo=github" alt="GitHub Sponsors"> </a> <a href="https://opencollective.com/astronrpa"> <img src="https://img.shields.io/badge/Sponsor-Open%20Collective-blue?style=for-the-badge&logo=opencollective" alt="Open Collective"> </a> </div> ## 📞 Getting Help - 📧 **Technical Support**: [[email protected]](mailto:[email protected]) - 💬 **Community Discussion**: [GitHub Discussions](https://github.com/iflytek/astron-rpa/discussions) - 🐛 **Bug Reports**: [Issues](https://github.com/iflytek/astron-rpa/issues) - 👥 **WeChat Work Group**: <div align="center"> <img src="./docs/images/WeCom_Group.png" alt="WeChat Work Group" width="300"> </div> ## 📄 License This project is open source under the [Open Source License](LICENSE). --- <div align="center"> **Developed and maintained by iFlytek** [![Follow](https://img.shields.io/github/followers/iflytek?style=social&label=Follow)](https://github.com/iflytek) [![Star](https://img.shields.io/github/stars/iflytek/astron-rpa?style=social&label=Star)](https://github.com/iflytek/astron-rpa) [![Fork](https://img.shields.io/github/forks/iflytek/astron-rpa?style=social&label=Fork)](https://github.com/iflytek/astron-rpa/fork) [![Watch](https://img.shields.io/github/watchers/iflytek/astron-rpa?style=social&label=Watch)](https://github.com/iflytek/astron-rpa/watchers) **AstronRPA** - Making RPA development simple and powerful! If you find this project helpful, please give us a ⭐ Star! </div>

AI Agents RPA

5.2K Github Stars

Open Source

astronclaw-tutorial

# AstronClaw & Loomy 教程 🦞 <p align="center"> <a href="https://iflytek.github.io/astronclaw-tutorial/"> <img src="https://img.shields.io/badge/AstronClaw_&_Loomy-Tutorial-blue?style=for-the-badge&logo=readthedocs" alt="AstronClaw Tutorial"> </a> </p> <p align="center"> <img src="https://bjcdn.openstorage.cn/aicontest/2026-03-18/29c37a17-5b33-4804-90b5-85599c29e2d5.png" alt="AstronClaw Logo" height="60">      <img src="https://loomy.xunfei.cn/images/logo_light.png" alt="Loomy Logo" height="60"> </p> <p align="center"> <a href="README_EN.md">English</a> | <b>简体中文</b> </p> <p align="center"> <a href="https://iflytek.github.io/astronclaw-tutorial/">🚀 <b>在线阅读</b></a> | <a href="https://agent.xfyun.cn/astron-claw">☁️ <b>体验云端龙虾</b></a> | <a href="https://loomy.xunfei.cn/">💻 <b>下载 Loomy 桌面端</b></a> </p> <p align="center"> <a href="https://github.com/iflytek/astronclaw-tutorial/blob/main/LICENSE"><img src="https://img.shields.io/github/license/iflytek/astronclaw-tutorial" alt="License"></a> <a href="https://github.com/iflytek/astronclaw-tutorial/actions/workflows/deploy.yml"><img src="https://img.shields.io/github/actions/workflow/status/iflytek/astronclaw-tutorial/deploy.yml?branch=main" alt="Deploy Status"></a> </p> ## 项目简介本项目是一个面向 **AstronClaw** 和 **Loomy** 的完整学习教程，帮助你从零开始掌握这款强大的 AI 助理系统。 * **AstronClaw**：基于 OpenClaw 核心能力打造的**云端 AI 助手**，提供全天候在线服务，随时随地通过企业微信、钉钉、飞书等渠道为你效劳。 * **Loomy**：聚焦真实办公场景的**桌面端 AI 工作搭子**，深入打通本地文件和系统工具，构建个人及小团队的高效自动化工作流。无论你是想快速上手使用 AstronClaw 提升效率，还是想通过 Loomy 打造专属工作流，本教程都能为你提供清晰的学习路径。 ## 核心内容模块本项目包含两大核心模块： ### ☁️ 第一部分：云端助手 AstronClaw * **快速上手**：一键极速部署，告别本地繁琐的环境配置，体验 7×24 小时在线的云端助手。 * **技能系统**：内置 130+ 官方技能，支持技能市场一键安装、仓库搜索、对话自动安装，甚至自定义技能。 * **渠道接入**：无缝对接飞书、钉钉、企业微信等企业级协作平台。 ### 💻 第二部分：桌面搭子 Loomy * **定位与特性**：低门槛、高安全、强适配、主动协作，专注于国内办公环境和跨工具流程。 * **典型工作场景**：自媒体运营、日常办公协同、投资与信息盯盘、日历与待办管理、远程移动办公、电商与业务运营。 * **安全与隐私**：目录级授权，保护本地文件安全；支持自定义大模型 API 服务商。 ## 谁适合学习 * **零基础用户**：不需要任何编程经验，想要一个随时待命的云端或桌面 AI 助手。 * **效率达人**：希望通过飞书、钉钉等即时通讯软件随时随地远程控制 AI。 * **内容与运营团队**：自媒体运营、电商从业者等需要频繁处理信息整理和多工具协作的人群。 ## 本地开发与预览本项目基于 [VitePress](https://vitepress.dev/) 构建。如果你想在本地预览或修改文档： ```bash # 1. 克隆仓库 git clone https://github.com/iflytek/astronclaw-tutorial.git cd astronclaw-tutorial # 2. 安装依赖 npm install # 3. 启动本地预览服务 npm run docs:dev # 4. 构建静态文件 npm run docs:build ``` ## 贡献与反馈欢迎提交 Issue 和 PR！让我们一起把它打磨得更好，帮助更多人让 AI 真正进入日常工作流。在提交 PR 之前，请阅读我们的 [贡献指南](CONTRIBUTING.md)。首次贡献时，CLA Assistant 机器人会自动在您的 PR 下方留言，引导您完成贡献者许可协议 (CLA) 的签署。 ## 加入交流群欢迎扫码加入官方交流群，与开发者和其他用户一起交流： | ☁️ AstronClaw 官方社群 | 💻 Loomy 交流群 | | :---: | :---: | | <img src="docs/public/astronclaw-qr.jpg" alt="AstronClaw 官方社群" width="250"> | <img src="docs/public/loomy-qr.png" alt="Loomy 交流群" width="250"> | ## 开源协议本项目基于 [Apache License 2.0](LICENSE) 协议开源。

AI Agents LMS

409 Github Stars

Open Source

skillhub

<div align="center"> <img src="./skillhub-logo.svg" alt="SkillHub Logo" width="120" height="120" /> <h1>SkillHub</h1> <p>An enterprise-grade, open-source agent skill registry — publish, discover, and manage reusable skill packages across your organization. </p> </div> <div align="center"> [![DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/iflytek/skillhub) [![Docs](https://img.shields.io/badge/docs-zread.ai-4A90E2?logo=gitbook&logoColor=white)](https://zread.ai/iflytek/skillhub) [![Discord](https://img.shields.io/badge/discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/qHYvtDNPHS) [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](./LICENSE) [![Build](https://github.com/iflytek/skillhub/actions/workflows/publish-images.yml/badge.svg)](https://github.com/iflytek/skillhub/actions/workflows/publish-images.yml) [![Docker](https://img.shields.io/badge/docker-ghcr.io-2496ED?logo=docker&logoColor=white)](https://ghcr.io/iflytek/skillhub) [![Java](https://img.shields.io/badge/java-21-ED8B00?logo=openjdk&logoColor=white)](https://openjdk.org/projects/jdk/21/) [![React](https://img.shields.io/badge/react-19-61DAFB?logo=react&logoColor=black)](https://react.dev) </div> <div align="center"> [English](./README.md) | [中文](./README_zh.md) </div> --- <div align="center"> <img src="https://xfyun-doc.xfyun.cn/lc-sp-skillhub-demo-1775551643410.gif" alt="SkillHub Demo" width="800" /> </div> SkillHub is a self-hosted platform that gives teams a private, governed place to share agent skills. Publish a skill package, push it to a namespace, and let others find it through search or install it via CLI. Built for on-premise deployment behind your firewall, with the same polish you'd expect from a public registry. ## Documentation - 📖 **[User Guide](https://iflytek.github.io/skillhub/)** — Skill publishing, search, CLI usage and other user guides - 🛠️ **[Developer Docs](https://zread.ai/iflytek/skillhub)** — Architecture, API reference, local development, deployment and operations ## Highlights - **Self-Hosted & Private** — Deploy on your own infrastructure. Keep proprietary skills behind your firewall with full data sovereignty. One `make dev-all` command to get running locally. - **Publish & Version** — Upload agent skill packages with semantic versioning, custom tags (`beta`, `stable`), and automatic `latest` tracking. - **Discover** — Full-text search with filters by namespace, downloads, ratings, and recency. Visibility rules ensure users only see what they're authorized to. - **Team Namespaces** — Organize skills under team or global scopes. Each namespace has its own members, roles (Owner / Admin / Member), and publishing policies. - **Review & Governance** — Team admins review within their namespace; platform admins gate promotions to the global scope. Governance actions are audit-logged for compliance. - **Social Features** — Star skills, rate them, and track downloads. Build a community around your organization's best practices. - **Account Merging** — Consolidate multiple OAuth identities and API tokens under a single user account. - **API Token Management** — Generate scoped tokens for CLI and programmatic access with prefix-based secure hashing. - **CLI-First** — Native REST API plus a compatibility layer for existing ClawHub-style registry clients. Native CLI APIs are the primary supported path while protocol compatibility continues to expand. - **Pluggable Storage** — Local filesystem for development, S3 / MinIO for production. Swap via config. - **Internationalization** — Multi-language support with i18next. ## Quick Start Start the full local stack with: ```bash rm -rf /tmp/skillhub-runtime curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up ``` The default command pulls the `latest` stable release images. Use `--version edge` if you want the newest build from `main`. **Configure public URL (recommended for production):** ```bash curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --public-url https://skillhub.your-company.com ``` The `--public-url` parameter sets the public access URL for your SkillHub instance. This ensures: - CLI install commands show the correct registry URL - Agent setup instructions display the correct skill.md URL - OAuth callbacks and device auth links work properly **For users in China (Aliyun mirror):** ```bash curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --aliyun --public-url https://skillhub.your-company.com --version latest ``` If deployment runs into problems, clear the existing runtime home and retry. ## SkillHub CLI Install and manage Agent skills from the command line: ```bash # Install CLI npm install -g @astron-team/skillhub # Or run directly npx @astron-team/skillhub@latest version # Login skillhub login --token sk_xxx --registry https://skill.xfyun.cn # Search and install skills skillhub search pdf skillhub install pdf-parser --agent codex # List installed skills skillhub list ``` 📖 Full guide: [docs/skillhub/en/guide/cli.md](docs/skillhub/en/guide/cli.md) ### Prerequisites - Docker & Docker Compose ### Local Development ```bash make dev-all ``` > **For developers in China**: If Maven dependency download times out, configure Aliyun mirror. See [Local Development Guide](https://iflytek.github.io/skillhub/quickstart.html#本地开发) for details. Then open: - Web UI: `http://localhost:3000` - Backend API: `http://localhost:8080` By default, `make dev-all` starts the backend with the `local` profile. In that mode, local development keeps the mock-auth users below and also creates a password-based bootstrap admin account by default: - `local-user` for normal publishing and namespace operations - `local-admin` with `SUPER_ADMIN` for review and admin flows Use them with the `X-Mock-User-Id` header in local development. The local bootstrap admin is enabled by default in `application-local.yml`: - username: `admin` - password: `ChangeMe!2026` - To disable it, set `BOOTSTRAP_ADMIN_ENABLED=false` before starting the backend. Stop everything with: ```bash make dev-all-down ``` Reset local dependencies and start from a clean slate with: ```bash make dev-all-reset ``` Run `make help` to see all available commands. Useful backend commands: ```bash make test make test-backend-app make build-backend-app ``` Do not run `./mvnw -pl skillhub-app clean test` directly under `server/`. `skillhub-app` depends on sibling modules in the same repo, and a standalone clean build can fall back to stale artifacts from the local Maven repository, which surfaces misleading `cannot find symbol` and signature-mismatch errors. Use `-am`, or the `make test-backend-app` and `make build-backend-app` targets above. For the full development workflow (local dev → staging → PR), see [docs/dev-workflow.md](docs/dev-workflow.md). ### API Contract Sync OpenAPI types for the web client are checked into the repository. When backend API contracts change, regenerate the SDK and commit the updated generated file: ```bash make generate-api ``` For a stricter end-to-end drift check, run: ```bash ./scripts/check-openapi-generated.sh ``` This starts local dependencies, boots the backend, regenerates the frontend schema, and fails if the checked-in SDK is stale. ### Container Runtime Published runtime images are built by GitHub Actions and pushed to GHCR. This is the supported path for anyone who wants a ready-to-use local environment without building the backend or frontend on their machine. Published images target both `linux/amd64` and `linux/arm64`. **Quick deployment with curl:** ```bash # Default (GHCR images) curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --public-url https://skillhub.your-company.com # Aliyun mirror (recommended for users in China) curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --aliyun --public-url https://skillhub.your-company.com --version latest ``` **Deployment parameters:** | Parameter | Description | Example | |-----------|-------------|---------| | `--public-url <url>` | Public access URL (recommended) | `--public-url https://skill.example.com` | | `--version <tag>` | Specific image tag | `--version v0.2.0` | | `--aliyun` | Use Aliyun mirror (China) | `--aliyun` | | `--home <dir>` | Runtime directory | `--home /opt/skillhub` | | `--no-scanner` | Disable security scanner | `--no-scanner` | > **Important**: Configure `--public-url` for production deployments to ensure CLI install commands and Agent setup instructions display the correct URLs. **Manual deployment:** 1. Copy the runtime environment template. 2. Pick an image tag. 3. Start the stack with Docker Compose. ```bash cp .env.release.example .env.release ``` Recommended image tags: - `SKILLHUB_VERSION=latest` for the latest stable release (default) - `SKILLHUB_VERSION=edge` for the latest `main` build - `SKILLHUB_VERSION=vX.Y.Z` for a fixed release Start the runtime: ```bash make validate-release-config docker compose --env-file .env.release -f compose.release.yml up -d ``` Then open: - Web UI: `SKILLHUB_PUBLIC_BASE_URL` 对应的地址 - Backend API: `http://localhost:8080` Stop it with: ```bash docker compose --env-file .env.release -f compose.release.yml down ``` The runtime stack uses its own Compose project name, so it does not collide with containers from `make dev-all`. The production Compose stack now defaults to the `docker` profile only. It does not enable local mock auth. The release template (`.env.release.example`) enables the bootstrap admin by default, so zero-config quickstart via `runtime.sh` works out of the box: - username: `admin` - password: `ChangeMe!2026` Recommended production baseline: - set `SKILLHUB_PUBLIC_BASE_URL` to the final HTTPS entrypoint - keep PostgreSQL / Redis bound to `127.0.0.1` - use external S3 / OSS via `SKILLHUB_STORAGE_S3_*` - change `BOOTSTRAP_ADMIN_PASSWORD` to a strong password (`validate-release-config.sh` rejects the default `ChangeMe!2026`) - rotate or disable the bootstrap admin after initial setup - run `make validate-release-config` before `docker compose up -d` If the GHCR package remains private, run `docker login ghcr.io` before `docker compose up -d`. ### Upload Allowlist Override Skill package upload validation uses the default extension allowlist from [`SkillPackagePolicy.java`](./server/skillhub-domain/src/main/java/com/iflytek/skillhub/domain/skill/validation/SkillPackagePolicy.java). `SkillPublishProperties` uses that same list by default for `skillhub.publish.allowed-file-extensions`. If you need to replace the default allowlist at runtime, set: ```bash SKILLHUB_PUBLISH_ALLOWED_FILE_EXTENSIONS=.md,.json,.xsd,.xsl,.dtd,.docx,.xlsx,.pptx ``` Spring Boot binds this environment variable to `skillhub.publish.allowed-file-extensions`. When set, it replaces the default allowlist instead of appending to it. ### Monitoring A Prometheus + Grafana monitoring stack lives under [`monitoring/`](./monitoring). It scrapes the backend's Actuator Prometheus endpoint. Start it with: ```bash cd monitoring docker compose -f docker-compose.monitoring.yml up -d ``` Then open: - Prometheus: `http://localhost:9090` - Grafana: `http://localhost:3001` (`admin` / `admin`) By default Prometheus scrapes `http://host.docker.internal:8080/actuator/prometheus`, so start the backend locally on port `8080` first. ## Kubernetes Basic Kubernetes manifests are available under [`deploy/k8s/`](./deploy/k8s): - `configmap.yaml` - `secret.yaml.example` - `backend-deployment.yaml` - `frontend-deployment.yaml` - `services.yaml` - `ingress.yaml` Apply them after creating your own secret: ```bash kubectl apply -f deploy/k8s/configmap.yaml kubectl apply -f deploy/k8s/secret.yaml kubectl apply -f deploy/k8s/backend-deployment.yaml kubectl apply -f deploy/k8s/frontend-deployment.yaml kubectl apply -f deploy/k8s/services.yaml kubectl apply -f deploy/k8s/ingress.yaml ``` ## Smoke Test A lightweight smoke test script is available at [`scripts/smoke-test.sh`](./scripts/smoke-test.sh). Run it against a local backend: ```bash ./scripts/smoke-test.sh http://localhost:8080 ``` ## Architecture ``` ┌─────────────┐ ┌─────────────┐ ┌──────────────┐ │ Web UI │ │ CLI Tools │ │ REST API │ │ (React 19) │ │ │ │ │ └──────┬──────┘ └──────┬──────┘ └──────┬───────┘ │ │ │ └───────────────────┼───────────────────┘ │ ┌──────▼──────┐ │ Nginx │ └──────┬──────┘ │ ┌──────▼──────┐ │ Spring Boot │ Auth · RBAC · Core Services │ (Java 21) │ OAuth2 · API Tokens · Audit └──────┬──────┘ │ ┌────────────┼────────────┐ │ │ │ ┌──────▼───┐ ┌─────▼────┐ ┌────▼────┐ │PostgreSQL│ │ Redis │ │ Storage │ │ 16 │ │ 7 │ │ S3/MinIO│ └──────────┘ └──────────┘ └─────────┘ ``` **Backend (Spring Boot 3.2.3, Java 21):** - Multi-module Maven project with clean architecture - Modules: app, domain, auth, search, storage, infra - PostgreSQL 16 with Flyway migrations - Redis for session management - S3/MinIO for skill package storage **Frontend (React 19, TypeScript, Vite):** - TanStack Router for routing - TanStack Query for data fetching - Tailwind CSS + Radix UI for styling - OpenAPI TypeScript for type-safe API client - i18next for internationalization ## Usage with Agent Platforms SkillHub works as a skill registry backend for several agent platforms. Point any of the clients below at your SkillHub instance to publish, discover, and install skills. ### [OpenClaw](https://github.com/openclaw/openclaw) [OpenClaw](https://github.com/openclaw/openclaw) is an open-source agent skill CLI. Configure it to use your SkillHub endpoint as the registry: ```bash # Configure registry URL export CLAWHUB_REGISTRY=https://skillhub.your-company.com # Authenticate once if needed clawhub login --token YOUR_API_TOKEN # Search and install skills npx clawhub search email npx clawhub install my-skill npx clawhub install my-namespace--my-skill # Publish to global namespace npx clawhub publish ./my-skill --slug my-skill --version 1.0.0 # Publish to a team namespace such as my-space npx clawhub publish ./my-skill --slug my-space--my-skill --version 1.0.0 ``` `my-space--my-skill` is the canonical compat slug. SkillHub parses it as namespace `my-space` plus skill slug `my-skill`. > 💡 **Tip**: The above commands are not only applicable to OpenClaw, but also to other CLI Coding Agents or Agent assistants by specifying the installation directory (`--dir`). For example: `npx clawhub --dir ~/.claude/skills install my-skill` 📖 **[Complete OpenClaw Integration Guide →](./docs/openclaw-integration.md)** ### [AstronClaw](https://agent.xfyun.cn/astron-claw) [AstronClaw](https://agent.xfyun.cn/astron-claw) is a cloud AI assistant built on OpenClaw's core capabilities, providing 24/7 online service through enterprise platforms like WeChat Work, DingTalk, and Feishu. It features a built-in skill system with over 130 official skills. You can connect it to a self-hosted SkillHub registry to enable one-click skill installation, search repository, dialogue-based automatic installation, and even custom skills management within your organization. ### [Loomy](https://loomy.xunfei.cn/) [Loomy](https://loomy.xunfei.cn/) is a desktop AI work partner focusing on real office scenarios. It integrates deeply with local files and system tools to build efficient automated workflows for individuals and small teams. By connecting Loomy to your SkillHub registry, you can easily discover and install organization-specific skills to enhance your local desktop automation and productivity. ### [astron-agent](https://github.com/iflytek/astron-agent) [astron-agent](https://github.com/iflytek/astron-agent) is the iFlytek Astron agent framework. Skills stored in SkillHub can be referenced and loaded by astron-agent, enabling a governed, versioned skill lifecycle from development to production. --- > 🌟 **Show & Tell** — Have you built something with SkillHub? We'd love to hear about it! > Share your use case, integration, or deployment story in the > [**Discussions → Show and Tell**](https://github.com/iflytek/skillhub/discussions/categories/show-and-tell) category. ## Contributing Contributions are welcome. Please open an issue first to discuss what you'd like to change. - Contribution guide: [`CONTRIBUTING.md`](./CONTRIBUTING.md) - Code of conduct: [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md) ## 📞 Support - 💬 **Community Discussion**: [GitHub Discussions](https://github.com/iflytek/skillhub/discussions) - 🐛 **Bug Reports**: [Issues](https://github.com/iflytek/skillhub/issues) - 👾 **Discord**: [Join our Server](https://discord.gg/qHYvtDNPHS) - 👥 **WeChat Work Group**: ![WeChat Work Group](https://github.com/iflytek/astron-agent/raw/main/docs/imgs/WeCom_Group.png) ## License Apache License 2.0

AI Agents

3.4K Github Stars

Open Source

iFly-Skills

# iFly-Skills 🚀 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE) [![CLA Assistant](https://img.shields.io/badge/CLA-Assistant-green.svg)](CLA.md) [English](README.md) | [中文](README_zh.md) Official collection of iFLYTEK skills for agent ecosystems and developer workflows. This repository serves as a centralized skill collection built on top of iFLYTEK AI capabilities. It currently includes reusable skills based on atomic model abilities such as speech, OCR, translation, proofreading, and multimodal understanding. Beyond atomic skills, this repository is designed to continuously expand toward more scenario-oriented skill packages. In the future, it will include not only single-capability skills, but also workflow-level and solution-level skills for real business scenarios, such as document processing, content production, intelligent review, multimodal analysis, and other integrated task chains. The goal of this repository is to provide a unified place for skill packaging, versioning, maintenance, and external distribution, making iFLYTEK capabilities easier to understand, install, combine, and evolve in agent-based ecosystems. ## 🌟 Available Skills Currently, the repository provides the following ready-to-use AI skills: | Skill Name | Description | Directory | |------------|-------------|-----------| | **Hyper TTS** | Ultra-realistic text-to-speech synthesis with advanced voice control. | [`ifly-hyper-tts`](./ifly-hyper-tts) | | **Image Understanding** | Multimodal capability to analyze and understand image contents. | [`ifly-image-understanding`](./ifly-image-understanding) | | **Invoice OCR** | Specialized OCR for extracting structured data from invoices. | [`ifly-ocr-invoice`](./ifly-ocr-invoice) | | **PDF/Image OCR** | General optical character recognition for documents and images. | [`ifly-pdf-image-ocr`](./ifly-pdf-image-ocr) | | **Speed Transcription** | High-speed audio transcription for voice-to-text scenarios. | [`ifly-speed-transcription`](./ifly-speed-transcription) | | **Text Proofread** | Intelligent text proofreading, error detection, and correction. | [`ifly-text-proofread`](./ifly-text-proofread) | | **Machine Translation** | High-quality, multi-language translation capabilities. | [`ifly-translate`](./ifly-translate) | | **Voice Clone TTS** | Voice cloning technology for customized text-to-speech generation. | [`ifly-voiceclone-tts`](./ifly-voiceclone-tts) | ## 🛠️ Usage Each skill is packaged in its own directory containing specific instructions, scripts, and metadata. To use a specific skill: 1. Navigate to the target skill's directory (e.g., `cd ifly-hyper-tts`). 2. Read the `SKILL.md` file for detailed API documentation, required environment variables (e.g., `XFEI_APP_ID`, `XFEI_API_KEY`, `XFEI_API_SECRET`), and usage examples. 3. Use the provided Python scripts or integrate the capability into your own agent workflow. ## 🤝 Contributing We welcome contributions to expand the iFLYTEK skills ecosystem! 1. Fork the repository. 2. Create your feature branch (`git checkout -b feature/new-skill`). 3. Commit your changes (`git commit -m 'feat: add awesome new skill'`). 4. Push to the branch (`git push origin feature/new-skill`). 5. Open a Pull Request. **Note:** When you submit a Pull Request, our CLA Assistant bot will automatically ask you to sign the [Contributor License Agreement (CLA)](CLA.md). Please follow the bot's instructions to complete the PR process. To avoid unrelated `signatures/version1/cla.json` diffs and merge conflicts in fork-based Pull Requests, CLA signatures are stored in a dedicated remote signature repository instead of this codebase. **Maintainer setup:** configure repository variables `CLA_SIGNATURE_STORE_ORG`, `CLA_SIGNATURE_STORE_REPO`, and optional `CLA_SIGNATURE_STORE_BRANCH`, plus repository secret `CLA_SIGNATURE_STORE_PAT` with write access to the remote signature repository. The branch used to store signatures should not be protected. ## 📄 License This project is licensed under the [Apache License 2.0](LICENSE). ## 💬 Community Join the Astron Open Source Community (WeCom Group) to discuss and collaborate: <img src="https://github.com/iflytek/astron-agent/raw/main/docs/imgs/WeCom_Group.png" alt="WeCom Group" width="300" />

AI Tools AI Agents LLM Tools & Chat UIs

182 Github Stars

Software by iflytek

astron-agent

astron-rpa

astronclaw-tutorial

skillhub

iFly-Skills