Readme

<em>Built-in Agent | Zero Setup | Any API Key | Multi-Agents | Remote Access | Cross-Platform | 24/7 Automation</em>

📋 Quick Navigation

Cowork in Action · Why Choose AionUi? · Quick Start · Community

Cowork — AI Agents That Work Alongside You

AionUi is more than a chat client. It's a Cowork platform where AI agents work alongside you on your computer — reading files, writing code, browsing the web, and automating tasks. You see everything the agent does, and you're always in control.

Built-in Agent — Install & Go, Zero Configuration

AionUi ships with a complete AI agent engine. Unlike tools that require you to install CLI agents separately, AionUi works the moment you install it.

• No CLI tools to install — the agent engine is built in
• No complex setup — sign in with Google or paste any API key
• Full agent capabilities — file read/write, web search, image generation, MCP (Model Context Protocol) tools
• Ready-to-use assistants — 20 built-in professional assistants (Cowork, PPT Creator, Word Creator, Excel Creator, Morph PPT 3D, Pitch Deck Creator, Dashboard Creator, Academic Paper Writer, Financial Model Creator, and more) ready to use immediately

Office assistants — PPT, Word & Excel

These tracks match what the app actually ships: Morph PPT presets and the pptx / docx / xlsx skills (see assistant/ presets and skills/ in the repo). Want document/table output? AionUi’s built-in OfficeCLI helps PPT (Morph), Word (.docx), and Excel (.xlsx/.xlsm/.csv) go from request to deliverable faster and more reliably. The three assistant types map to file workflows, and the final outputs are directly editable and reusable.

PPT assistant

Output: editable Morph PPT (.pptx) Morph-animated slide-to-slide transitions with coherent story pacing; powered by OfficeCLI.

</td>
<td align="center" width="50%">
  
</td>

Word assistant

Output: editable Word (.docx) Paper/thesis writing and production-ready document editing via the docx skill; powered by OfficeCLI.

</td>
<td align="center" width="50%">
  
</td>

Excel assistant

Output: usable Excel (.xlsx/.xlsm/.csv) Generate/refresh spreadsheets with xlsx for analysis, auto-formatting, and charts; powered by OfficeCLI.

</td>
<td align="center" width="50%">
  
</td>

Multi-Agent Mode — Already Have CLI Agents? Bring Them In

If you already use Claude Code, Codex, Hermes Agent, or OpenClaw, AionUi auto-detects them and lets you Cowork with all of them — alongside the built-in agent.

Supported Agents: Built-in Agent (zero setup) • Claude Code • Codex • Qwen Code • Goose AI • OpenClaw • Augment Code • CodeBuddy • Kimi CLI • OpenCode • Factory Droid • GitHub Copilot • Qoder CLI • Mistral Vibe • Nanobot • Aion CLI (aionrs, the Rust-based backend service bundled with AionUi) • Snow CLI • Kiro • Hermes Agent • Cursor Agent and more

• Auto Detection — automatically recognizes installed CLI tools
• Unified Interface — one Cowork platform for all your AI agents
• Parallel Sessions — run multiple agents simultaneously with independent context
• MCP Unified Management — configure MCP (Model Context Protocol) tools once, automatically sync to all agents — no need to configure each agent separately
• YOLO Mode (auto-approve all agent actions without manual confirmation) / Full-Auto Mode — one click to bypass permission prompts; all agents support full-auto mode for unattended execution

Team Mode — Coordinated Multi-Agent Collaboration

Run multiple AI agents as an organized team: a Leader agent receives your instructions, breaks them into subtasks, and delegates to Teammate agents via a built-in Team MCP Server. Teammates execute in parallel, share results through an async mailbox, and write to a shared task board.

• Parallel multi-agent execution — Leader breaks tasks into subtasks and delegates to Teammate agents running in parallel; each Teammate uses its own model via ACP (Agent Communication Protocol, AionUi's multi-agent coordination layer), Gemini, or Aionrs
• Leader orchestration — Leader assigns, tracks, and aggregates results; supported backends include Claude Code, Codex, Hermes Agent, Gemini, Snow CLI, and Aion CLI
• Team-isolated workspace — all agents share the same folder; each has its own permission dialog with sidebar badge for pending approvals

• Shared Workspace — all agents read/write the same folder; the file panel stays visible throughout
• Supported backends — Claude Code, Codex, Gemini, Snow CLI, Aion CLI (aionrs); other ACP backends with mcpCapabilities.stdio are auto-supported
• Dynamic scaling — add or remove Teammates while the team is running; silent agents auto-escalate to failed with one-click removal
• Granular permissions — each agent has its own permission confirmation dialog; sidebar badge shows pending approvals
• File sharing — Leader can pass file attachments to Teammates

Any API Key, Full Cowork Agent Power

Other AI apps give you a chatbox with your API key. AionUi gives you a full Cowork agent.

Same agent capabilities — file read/write, web search, image generation, tool use — regardless of which model powers it. AionUi supports 20+ AI platforms including cloud services and local deployments.

Comprehensive Platform Support:

• Official Platforms — Gemini, Gemini (Vertex AI), Anthropic (Claude), OpenAI
• Cloud Providers — AWS Bedrock, New API (unified AI model gateway)
• Chinese Platforms — Dashscope (Qwen), Zhipu, Moonshot (Kimi), Qianfan (Baidu), Hunyuan (Tencent), Lingyi, ModelScope, InfiniAI, Ctyun, StepFun
• International Platforms — DeepSeek, MiniMax, OpenRouter, SiliconFlow, xAI, Ark (Volcengine), Poe
• Local Models — Ollama, LM Studio (via Custom platform with local API endpoint)

AionUi also supports NewAPI gateway service — a unified AI model hub that aggregates and distributes various LLMs. Flexibly switch between different models in the same interface to meet various task requirements.

Extensible Assistants & Skills

Extensible assistant system with 20 built-in professional assistants and a three-tier skill system. Create and manage your own assistants and skills.

• Create Custom Assistants — Define your own assistants with custom rules and capabilities
• Three-tier Skills — Builtin skills (shipped with AionUi), custom skills (your own), and Extension skills (contributed by third-party extensions); enable/disable per conversation with the skill indicator
• Per-conversation Control — A skill indicator in the chat header shows active skills for the current conversation; search and exclude skills as needed

AionUi supports three skill layers: built-in skills (shipped with the app), custom skills (user-defined), and extension skills (loaded from the Extension SDK).

AionUi includes 20 professional assistants with predefined capabilities, extendable through custom skills:

• 🤝 Cowork — Autonomous task execution (file operations, document processing, workflow planning)
• 📊 PPT Creator / Morph PPT / Morph PPT 3D — Generate and animate PPTX presentations with Morph transitions
• 📐 Pitch Deck Creator — Investor-ready pitch deck generation
• 📊 Dashboard Creator — Data dashboard generation
• 📝 Word Creator — Production-ready Word (.docx) document generation
• 📗 Excel Creator — Spreadsheet generation with analysis, charts, and auto-formatting
• 🎓 Academic Paper Writer — Structured academic paper writing
• 💰 Financial Model Creator — Financial models and projections
• ⭐ Star Office Helper — Office productivity assistant
• 📄 PDF to PPT — Convert PDF to PPT
• 🎮 3D Game — Single-file 3D game generation
• 🎨 UI/UX Pro Max — Professional UI/UX design (57 styles, 95 color palettes)
• 📋 Planning with Files — File-based planning for complex tasks (Manus-style persistent markdown planning)
• 🧭 HUMAN 3.0 Coach — Personal development coach
• 📣 Social Job Publisher — Job posting and publishing
• 🦞 moltbook — Zero-deployment AI agent social networking
• 📈 Beautiful Mermaid — Flowcharts, sequence diagrams, and more
• 🔧 OpenClaw Setup — Setup and configuration assistant for OpenClaw integration
• 📖 Story Roleplay — Immersive story roleplay with character cards and world info (SillyTavern compatible)

Custom Skills: Create skills in the skills/ directory, enable/disable skills for assistants to extend AI capabilities. Skills come from three sources: builtin (shipped with AionUi), custom (your own), and Extension (contributed via the Extension SDK). Built-in skills include pptx, docx, pdf, xlsx, mermaid, and more.

💡 Each assistant is defined by a markdown file. Check the assistant/ directory for examples.

Cowork from Anywhere

Your 24/7 AI assistant — access AionUi from any device, anywhere.

• WebUI Mode — access via browser from phone, tablet, or any computer. Supports LAN, cross-network, and server deployment. QR code or password login.

• Chat Platform Integration

  • Telegram — Cowork with your AI agent directly from Telegram
  • Lark (Feishu) — Cowork through Feishu bots for enterprise collaboration
  • DingTalk — AI Card streaming with automatic fallback
  • WeChat — Personal WeChat account integration
  • WeCom (企业微信) — Enterprise WeChat bot for team collaboration
  • Slack and more platforms coming soon

Setup: AionUi Settings → WebUI Settings → Channel, configure the Bot Token.

Remote Internet Access Tutorial

✨ Cowork in Action

Scheduled Tasks — Cowork on Autopilot

Set it up once, the AI agent runs automatically on schedule — truly 24/7 unattended operation.

• Natural Language — tell the agent what to do, just like chatting
• Three scheduling modes — standard cron expression (with timezone), fixed interval (every N minutes/hours), or one-time trigger
• AI-created tasks — agents can autonomously create scheduled tasks during a conversation
• Use Cases: scheduled data aggregation, report generation, file organization, reminders

Scheduling modes:

• Cron expression — standard 5-field cron with timezone support (e.g. 0 9 * * 1, Asia/Shanghai)
• Every N minutes/hours — fixed interval, e.g. run every 30 minutes
• One-time — trigger once at a specified datetime, then auto-disable

Execution modes:

• Continue in existing conversation — appends to the bound conversation so the AI retains full context history
• Create new conversation each time — opens a fresh session on each trigger, ideal for independent periodic reports

Other capabilities:

• Conversation-Bound — Each scheduled task is bound to a conversation, maintaining context and history
• Automatic Execution — Tasks run automatically at scheduled times, sending messages to the conversation
• Easy Management — Create, modify, enable/disable, delete, and view scheduled tasks anytime
• Keep-awake — AionUi automatically prevents system sleep while tasks are active, and detects missed triggers after wake
• Advanced config — each task can have its own model, workspace directory, and reasoning effort settings

Real-World Examples:

• Daily weather report generation
• Weekly sales data aggregation
• Monthly backup file organization
• Custom reminder notifications

Preview Panel — Instantly View AI-Generated Results

10+ formats: PDF, Word, Excel, PPT, code, Markdown, images, HTML, Diff — view everything without switching apps.

• Instant Preview — after the agent generates files, view results immediately without switching apps
• Real-time Tracking + Editable — automatically tracks file changes; supports live editing of Markdown, code, HTML
• Multi-Tab Support — open multiple files simultaneously, each in its own tab
• Version History — view and restore historical versions of files (Git-based)

Supported Preview Formats:

• Documents — PDF, Word (.doc, .docx, .odt), Excel (.xls, .xlsx, .ods, .csv), PowerPoint (.ppt, .pptx, .odp)
• Code — JavaScript, TypeScript, Python, Java, Go, Rust, C/C++, CSS, JSON, XML, YAML, Shell scripts, and 30+ programming languages
• Markup — Markdown (.md, .markdown), HTML (.html, .htm)
• Images — PNG, JPG, JPEG, GIF, SVG, WebP, BMP, ICO, TIFF, AVIF
• Other — Diff files (.diff, .patch)

Smart File Management — Automated File Operations

Batch renaming, automatic organization, smart classification, file merging — the Cowork agent handles it for you.

• Auto Organize — Intelligently identify content and auto-classify, keeping folders tidy
• Efficient Batch — One-click rename, merge files, say goodbye to tedious manual tasks
• Automated Execution — AI agents can independently execute file operations, read/write files, and complete tasks automatically

Use Cases:

• Organize messy download folders by file type
• Batch rename photos with meaningful names
• Merge multiple documents into one
• Auto-classify files by content

Excel Data Processing — AI-Powered Analysis

Deeply analyze Excel data, automatically beautify reports, and generate insights — all powered by AI agents.

• Smart Analysis — AI analyzes data patterns and generates insights
• Auto Formatting — Automatically beautify Excel reports with professional styling
• Data Transformation — Convert, merge, and restructure data with natural language commands
• Report Generation — Create comprehensive reports from raw data

Use Cases:

• Analyze sales data and generate monthly reports
• Clean and format messy Excel files
• Merge multiple spreadsheets intelligently
• Create data visualizations and charts

AI Image Generation & Editing

Intelligent image generation, editing, and recognition, powered by Gemini

• Text-to-Image — Generate images from natural language descriptions
• Image Editing — Modify and enhance existing images
• Image Recognition — Analyze and describe image content
• Batch Processing — Generate multiple images at once

Image generation model configuration guide

Document Generation — PPT, Word, Markdown

Automatically generate professional documents — presentations, reports, and more — with AI agents.

• PPTX Generator — Create professional presentations from outlines or topics
• Word Documents — Generate formatted Word documents with proper structure
• Markdown Files — Create and format Markdown documents for documentation
• PDF Conversion — Convert between various document formats

Use Cases:

• Generate quarterly business presentations
• Create technical documentation
• Convert PDF to editable formats
• Auto-format research papers

Personalized Interface Customization

Customize with your own CSS code, make your interface match your preferences

• ✅ Fully Customizable — Freely customize interface colors, styles, layout through CSS code, create your exclusive experience

Multi-Task Parallel Processing

Open multiple conversations, tasks don't get mixed up, independent memory, double efficiency

• ✅ Independent Context — Each conversation maintains its own context and history
• ✅ Parallel Execution — Run multiple tasks simultaneously without interference
• ✅ Smart Management — Easy switching between conversations with visual indicators

🤔 Why Choose AionUi Over Claude Cowork?

AionUi is a free and open-source Multi-AI Agent Desktop. Compared to Claude Cowork which only runs on macOS and is locked to Claude, AionUi is its full-model, cross-platform enhanced version.

Deep AI Office Scenario Support:

• File Management: Intelligently organize local folders and batch rename with one click.
• Data Processing: Deeply analyze and automatically beautify Excel reports.
• Document Generation: Automatically write and format PPT, Word, and Markdown documents.
• Instant Preview: Built-in 10+ format preview panels, AI collaboration results instantly visible.

Quick Q&A

See How People Use AionUi

Community Articles

• Open-source free Cowork, full model integration + autonomous file operations — Open Source AI Project Landing
• Making ordinary people use Claude Code like an APP — Lazy Cat Loves Fishing
• 5500 Stars: How Open Source Breaks Anthropic's AI Tool Moat — AI Silicon Moment

Made a video about AionUi? Let us know on X and we'll feature it here!

🚀 Quick Start

System Requirements

• macOS: 10.15 or higher
• Windows: Windows 10 or higher
• Linux: Ubuntu 18.04+ / Debian 10+ / Fedora 32+
• Memory: 4GB+ recommended
• Storage: 500MB+ available space

Install

Click the button above to go to the Releases page and download the installer for your platform (macOS / Windows / Linux).

# Alternatively, macOS via Homebrew
brew install aionui

Get Started in 3 Steps

1. Install AionUi
2. Sign in with Google account or enter any API key
3. Start Coworking — the built-in AI agent is ready to go

📖 Detailed Guides

🚀 Quick Start

• 📖 Complete Installation Guide — Detailed steps from download to configuration
• ⚙️ LLM Configuration Guide — Multi-platform AI model configuration
• 🤖 Multi-Agent Mode Setup — Integrate terminal AI agents
• 🔌 MCP Tool Configuration — Model Context Protocol server setup
• 🌐 WebUI Configuration Guide — Complete WebUI setup and configuration tutorial

🎯 Use Cases

• 📁 File Management — Smart file organization
• 📊 Excel Processing — AI-driven data processing
• 🎨 Image Generation — AI image creation
• 📚 More Use Cases

❓ Support & Help

• ❓ FAQ — Questions and troubleshooting
• 🔧 Configuration & Usage Tutorials — Complete configuration documentation

💬 Community & Support

Your ideas matter! We value every suggestion and feedback.

• GitHub Discussions — share ideas and exchange tips
• Report Issues — bugs and feature requests
• Release Updates — get the latest version
• Discord Community — English community
• WeChat Group — Chinese community

Contributing

Please read CONTRIBUTING.md before opening a PR.

1. Fork this project
2. Create a 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

Development Setup

Tech stack: Electron · Vite · React · Bun

bun install        # install dependencies
bun run dev        # start dev server
bun run test       # run unit tests

License

This project is licensed under Apache-2.0.

Contributors

Star History

If you like it, give us a star

Report Bug · Request Feature

_{<a href="https://linux.do/">LINUX DO - A New Ideal Community</a>}