Installation | AIOS Docs (original) (raw)

For the complete documentation index, see llms.txt. This page is also available as Markdown.

  1. Getting Started

Installation

Step 1: Install AIOS Kernel

Git clone AIOS kernel

git clone https://github.com/agiresearch/AIOS.git

Create venv environment

python3.x -m venv venv # Only support for Python 3.10 and 3.11
source venv/bin/activate

or create conda environment

conda create -n venv python=3.x  # Only support for Python 3.10 and 3.11
conda activate venv

We strongly recommend using uv for faster and more reliable package installation.

To install uv:

For GPU environments:

For CPU-only environments:

Alternatively, if you prefer using pip:

For GPU environments:

For CPU-only environments:

Step 2: Install AIOS SDK (Cerebrum)

  1. Clone the Cerebrum repository:
  2. Install using uv (recommended):
    Or using pip:

Note: The machine where the AIOS kernel (AIOS) is installed must also have the AIOS SDK (Cerebrum) installed. Installing AIOS kernel will install the AIOS SDK automatically by default. If you are using the Local Kernel mode, i.e., you are running AIOS and agents on the same machine, then simply install both AIOS and Cerebrum on that machine. If you are using Remote Kernel mode, i.e., running AIOS on Machine 1 and running agents on Machine 2 and the agents remotely interact with the kernel, then you need to install both AIOS kernel and AIOS SDK on Machine 1, and install the AIOS SDK alone on Machine 2.

Then you can follow the instructions in the Quickstart to launch AIOS. 

uv pip install -r requirements-cuda.txt
uv pip install -r requirements.txt
pip install -r requirements-cuda.txt
pip install -r requirements.txt
git clone https://github.com/agiresearch/Cerebrum.git
cd Cerebrum && uv pip install -e .
cd Cerebrum && pip install -e .