Documentation
Everything you need to know about using AIOS
Quick Navigation
Need more help?
Installation Guide
1System Requirements
Before installing AIOS, ensure your system meets the following requirements:
- •Windows 10 or 11 (64-bit)
- •8GB RAM minimum (16GB recommended)
- •2GB free disk space
- •Internet connection
2Download and Installation
- a.
Download the latest AIOS installer package from our official website.
- b.
Run the installer and follow the on-screen instructions.
- c.
Select your preferred installation location or use the default path.
- d.
Choose which components to install (recommended: all components).
3Initial Configuration
- a.
Launch AIOS after installation.
- b.
Create an account or sign in with your existing credentials.
- c.
Choose your pricing option: use your own API keys or purchase AIOS points.
- d.
If using your own API keys, enter them in the settings panel.
- e.
Select which MCPs to enable (you can change this later).
Note on Security Permissions
AIOS will request various system permissions based on the MCPs you enable. For example, the Filesystem Access MCP requires permission to access specific folders. You can adjust these permissions at any time in the Settings panel.
Please run the app as an administrator if you want to get the best out of it.
MCP Documentation
Model Context Protocols (MCPs) extend your AI assistant's capabilities by connecting it with external systems and data sources. This section provides detailed documentation for each available MCP.
Computer Use Agent
The Computer Use Agent (CUA) allows AIOS to interact with your Windows system, helping you accomplish tasks efficiently through natural language commands.
Key Features:
- •Natural language control of Windows applications
- •Automated workflow assistance
- •System management and monitoring
For detailed CUA documentation, including commands and use cases, see the full CUA guide.
Our detailed API reference is currently being finalized. Soon you'll have access to comprehensive guides, endpoint references, and integration examples.
API Reference
AIOS provides a comprehensive API for developers who want to integrate AIOS capabilities into their own applications.
Available Endpoints:
| Endpoint | Method | Description |
|---|---|---|
/api/chat | POST | Send a message to an AI model |
/api/models | GET | List available AI models |
/api/mcps | GET | List enabled MCPs |
Security & Privacy
AIOS is designed with security and privacy as core principles. We implement multiple layers of protection to keep your data safe.
Security Features:
- •Granular permission controls for all MCPs
- •Local processing options to keep data on your device
- •Regular security audits and updates
Privacy Commitments:
- •No data collection without explicit consent
- •Option to opt out of all telemetry
- •Clear data retention policies
- •Compliance with GDPR and other regulations
Voice Interface
AIOS provides a natural voice interface that allows hands-free interaction with your AI assistant. Simply speak to AIOS as you would type, with complete flexibility to express any command or question conversationally.
Natural Conversation
Unlike traditional voice assistants with rigid command structures, AIOS understands natural language. You can speak to it naturally and Multi-turn dialogue is coming soon.
Example Voice Interactions:
- •"Hey AIOS, can you summarize the documents in my project folder?"
- •"Search for recent research papers about quantum computing and create a summary."
- •"What's on my calendar for tomorrow and send a meeting preparation email to the participants."
- •"Analyze the data in this spreadsheet and create a visualization of the main trends."
Quick Tip
For best voice recognition results, place your microphone in a location with minimal background noise and speak clearly.
Troubleshooting
If you encounter issues with AIOS, use this troubleshooting guide to identify and resolve common problems. If you need additional assistance, please contact our support team.
Connection Issues
Symptom: Cannot connect to AI models
Possible causes:
- Internet connection is down
- API keys are invalid or expired
- Server is experiencing high traffic
Solution: Check your internet connection, verify API keys in Settings → API Keys, and try again later if servers are busy.
Permission Errors
Symptom: "Permission denied" errors when using MCPs
Possible causes:
- Required permissions not granted
- Access to restricted directories
- Security software blocking access
Solution: Review and update MCP permissions in Settings → MCPs → Permissions, ensure you're not accessing restricted paths, and check your security software settings.
Performance Issues
Symptom: AIOS running slowly or unresponsive
Possible causes:
- Low system resources
- Too many MCPs enabled simultaneously
- Large conversation history consuming memory
Solution: Close unused applications, disable unnecessary MCPs, clear conversation history in Settings → Data Management, and restart AIOS.
Diagnostic Tools
AIOS includes built-in diagnostic tools to help identify and resolve issues:
- •System Diagnostics: Run a complete system check (Help → Run Diagnostics)
- •Connection Test: Verify API connectivity (Settings → Connectivity → Test Connection)
- •Log Files: Access detailed logs for error analysis (Help → View Logs)
- •Reset Settings: Return to default configuration (Settings → Advanced → Reset)