AIOS (AI Agent Operating System)

AIOS (AI Agent Operating System) is designed to facilitate the development and deployment of LLM-based agents by managing resources like LLM, memory, storage, and tools. The architecture is split into two primary components:

1. AIOS Kernel: An abstraction layer over the OS kernel that manages agent resources (LLM, memory, storage, tools). This repository contains the kernel.
2. AIOS SDK (Cerebrum): Designed for developers and users to build and run agent applications by interacting with the kernel. The SDK is located in the Cerebrum repository.

For computer-use agents, the kernel includes a specialized architecture with a redesigned Tool Manager that incorporates a VM (Virtual Machine) Controller and MCP Server to provide a sandboxed environment.

To use the VMware provider in AIOS, you must first install the appropriate virtualization software based on your operating system:

• Linux: Download VMware Workstation Pro (version 17.5.1 is recommended). Run the .bundle installer using the --console flag.
• Windows: Download VMware Workstation Pro. Ensure you are logged in as an Administrator or a user in the local Administrators group. Run the .exe installer and reboot if prompted.
• macOS (Apple Silicon): Download VMware Fusion. Open the .dmg file and follow the 'Install Fusion' prompts. You will need to provide your administrator credentials and an activation key during installation.

Use the LibreOffice command line to convert an XLSX file to a CSV file. This is useful for sheet_print evaluation types.

Command Syntax: libreoffice --convert-to "csv:Text - txt - csv (StarCalc):44,34,UTF8,,,,false,true,true,false,false,1" --out-dir <output_dir> <input_file>

Note: The last integer in the conversion options string (e.g., 1) specifies the sheet number to export (starting from 1).

libreoffice --convert-to "csv:Text - txt - csv (StarCalc):44,34,UTF8,,,,false,true,true,false,false,1" --out-dir /home/user /home/user/abc.xlsx

To enable remote control of VLC via an HTTP interface:

1. Open Tools > Preferences.
2. At the bottom left, select All under Show settings.
3. Expand Interface > Main interfaces and check Web.
4. Expand Main interfaces > Lua.
5. Under Lua HTTP, set a password in the password field.
6. Save and Restart VLC.
7. Access the interface at http://localhost:8080 using the password you set.

To allow tools like Playwright to control an existing Chrome instance, start Chrome with the --remote-debugging-port flag.

1. Edit your Chrome shortcut properties.
2. Append --remote-debugging-port=9222 to the end of the Target field.
3. Example Target: "C:\Path\To\Chrome.exe" --remote-debugging-port=9222.
4. Verify by navigating to http://localhost:9222 in a browser.

While developing, you can add aios-rs to another Rust crate using a path dependency.

[dependencies]
aios-rs = { path = "../aios-rs" }

To use VirtualBox as a provider in AIOS, follow these steps:

1. Download: Get the installer from the official VirtualBox website.
   • Note for Apple Silicon: VirtualBox is not supported on Apple chips (M1, M2, etc.). Use VMware Fusion instead.
2. Install: Run the installer and follow the provided instructions.
3. Configure Windows PATH: If you are on Windows, you must add the VirtualBox installation directory to your system PATH environment variable to enable the VBoxManage command. The default path is typically C:\Program Files\Oracle\VirtualBox.
4. Verify: Confirm the installation by running the version command in your terminal.

VBoxManage --version

AIOS supports multiple agent creation frameworks, including:

• ReAct
• Reflexion
• OpenAGI
• AutoGen
• Open Interpreter
• MetaGPT

Agents created with these frameworks can be onboarded to AIOS. Detailed onboarding guidelines are available in the official documentation: How to develop agents.

To install the AIOS kernel, clone the repository and set up a Python environment (Python 3.10 or 3.11 is required). It is recommended to use uv for faster installation.

Step 1: Clone and Environment Setup

git clone https://github.com/agiresearch/AIOS.git
# Using venv
python3.x -m venv venv
source venv/bin/activate
# OR using conda
conda create -n venv python=3.x
conda activate venv

Step 2: Install Dependencies

For GPU environments:

uv pip install -r requirements-cuda.txt
# or with pip
pip install -r requirements-cuda.txt

For CPU-only environments:

uv pip install -r requirements.txt
# or with pip
pip install -r requirements.txt

To submit changes:

1. Push your feature branch to your fork on GitHub.
2. Click "Compare & pull request".
3. Select the appropriate base branch:
   • Use the dev branch for new features.
   • Use the main branch if your changes do not affect original functions.
4. Provide a clear title and description, and select relevant labels.

To verify the current state of the aios-rs scaffold, run the test suite from the repository root.

cd aios-rs
cargo test