-
Notifications
You must be signed in to change notification settings - Fork 1.3k
FAQ
This FAQ covers the most common questions and issues users encounter when using AionUi.
A: AionUi is available for Windows, macOS, and Linux. Download the latest release from our GitHub releases page and follow the installation instructions for your operating system.
A:
- Operating System: Windows 10+, macOS 10.15+, or Linux (Ubuntu 18.04+)
- Memory: Minimum 4GB RAM, recommended 8GB+
- Storage: At least 2GB free space
- Network: Internet connection for AI model access
A: AionUi requires modern operating systems due to its Electron-based architecture. We recommend updating to supported versions for the best experience.
A: No, you can start with just one platform. We recommend beginning with Google Gemini (free) or OpenAI (if you have credits). You can add more platforms later as needed.
A:
- Visit Google AI Studio
- Sign in with your Google account
- Navigate to "Get API Key" and create a new key
- Copy the key and paste it into AionUi's LLM settings
A:
- Verify the key is correctly copied (no extra spaces or characters)
- Check if the key has expired or been revoked
- Ensure you have sufficient credits/quota remaining
- Try regenerating the key from the platform's dashboard
A: Yes! AionUi supports multiple API keys per platform with automatic rotation. This helps with rate limits and reliability.
A: AionUi is a free, open-source, Cowork app with AI Agents - a desktop application where AI agents work alongside you on your computer. AionUi ships with a complete AI agent engine built in, so it works the moment you install it. Key features include:
- Built-in Agent | Zero Setup - Complete AI agent engine built in, no CLI tools to install
- Multi-Agent Collaboration - If you already have CLI agents (Claude Code, Qwen Code, Codex, and 15+ more), AionUi auto-detects and integrates them
- Automated Task Execution - AI agents can independently execute tasks, run scripts, read/write files, and operate tools automatically
- Workflow Automation - Complete workflow automation capabilities with file system operations and task completion
- Cross-Platform Support - Available on macOS, Windows, and Linux
- Free & Open Source - Complete open source solution with no subscription fees
A: Main differences:
- Built-in Agent Mode: AionUi's built-in core functionality, used by default after installation, supports image generation, tool scheduling and other complete features - no CLI tools to install
- Multi-Agent Mode: If you already have external CLI tools installed, AionUi auto-detects and integrates them through ACP protocol, currently has relatively simple functionality, future MCP settings will enhance integration
A: Selection recommendations:
- Daily use: Recommend Built-in Agent mode, most complete functionality, ready to use out of the box - no setup required
- Professional needs: If you already have specific CLI tools installed (like Claude Code, Qwen Code, etc.), you can use Multi-Agent Mode to integrate them
- Future planning: MCP functionality will allow Multi-Agent Mode to enjoy more unified features
A: Model switching is not currently supported. Switching to different agents will automatically use their default models:
- Built-in Agent Mode: Uses configured default models
- Multi-Agent Mode: Choose different agents on the welcome page, each agent uses its default model
- Note: Model switching during current conversation is not currently supported
A: Check the following configuration:
- Enable image generation in "Tools Settings"
- Select a model that supports image generation
- Refer to Image Generation Configuration Guide
A: We recommend Gemini 2.5 Flash Image Preview for high-quality image generation. Check Google AI Studio for current pricing policies.
A:
- Set up a platform with image models (Gemini or OpenRouter)
- Go to Settings โ Tools โ Image Generation
- Select an image generation model
- Test with a simple prompt like "Generate a sunset landscape"
A:
- Choose faster models (like Gemini image models)
- Reduce image resolution requirements
- Check your internet connection
- Consider upgrading to premium models for better performance
A: All conversations are saved locally:
-
macOS:
~/Library/Application Support/AionUi/ -
Windows:
%APPDATA%/AionUi/ -
Linux:
~/.config/AionUi/
A:
- Manually copy the configuration file directory
- Export your configuration file
- Store it safely for future restoration
A: Yes, you can reset settings:
- Close AionUi completely
- Delete the configuration folder
- Restart AionUi to create fresh settings
A:
- Check if another instance is already running
- Restart your computer
- Reinstall AionUi if the problem persists
- Check our GitHub issues for known problems
A:
- Verify the key is correctly entered
- Check if the key has expired
- Ensure you have sufficient credits
- Try regenerating the key
A:
- Check if you have write permissions to the AionUi data directory
- Ensure sufficient disk space is available
- Try restarting AionUi
A:
- Close unnecessary applications to free up memory
- Check your internet connection
- Try reducing the number of concurrent conversations
- Restart AionUi
A:
- Automatic: AionUi will notify you of updates
- Manual: Download the latest version from GitHub releases
- Settings: Check for updates in Settings โ About
A: No, updates preserve your settings and conversation history. However, we recommend backing up important data before major updates.
A: We release updates regularly with new features, bug fixes, and improvements. Follow our GitHub releases for the latest updates.
A:
- Conversations are stored locally on your device
- API keys are encrypted and stored securely
- We don't collect personal data without your consent
- Review our privacy policy for detailed information
A:
- Manually delete conversation data from the configuration file directory
- Or delete the entire configuration folder to reset all data
- Restart AionUi to apply changes
A:
- GitHub Issues: Report bugs and request features
- GitHub Discussions: Ask questions and share tips
- Documentation: Check our comprehensive guides
- Community: Join our user community for support
A:
- Code: Submit pull requests for bug fixes and features
- Documentation: Help improve our guides and tutorials
- Testing: Report issues and provide feedback
- Community: Help other users in discussions
A: Yes! AionUi is completely free and open source and available on GitHub. As a free, open-source Cowork app with AI Agents, AionUi provides:
- Full source code access
- Community-driven development
- No subscription fees or hidden costs
- Transparent development process
- We welcome contributions from the community
- Getting Started Guide: Complete setup tutorial
- LLM Configuration: Detailed model setup guide
- Multi-Agent Mode Setup: External CLI tool integration
- Image Generation Setup: Image generation configuration
Still have questions? Open an issue or start a discussion on GitHub!
Welcome to the comprehensive AionUi documentation! Find everything you need to configure, use, and master AionUi.
- โ๏ธ LLM Configuration
- ๐ค Multi-Agent Mode Setup
- ๐จ Image Generation Setup
- ๐ MCP Configuration
- ๐ป WebUI Configuration(by Commond Line)
- ๐ AionUi Remote Internet Access Tutorial
- ๐ค DingTalk Bot Setup
- โฐ Scheduled Tasks Guide
- ๐ ๏ธ AI Assistants & Skills Ecosystem
- ๐ Preview Panel Guide
- ๐ File Management
- ๐ Excel Smart Processing
- ๐ Smart Information Gathering
- ๐ Local Knowledge Base Application
- โ AI Learning Assistant
- โ๏ธ Writing & Content Creation
- ๐ Getting Started
- โ๏ธ LLM Configuration
- ๐ค Multi-Agent Mode Setup
- ๐จ Image Generation
- ๐ MCP Configuration
- ๐ WebUI Configuration
- โฐ Scheduled Tasks
- ๐ ๏ธ AI Assistants & Skills
- ๐ Preview Panel
- โ FAQ