# Installation

### Prerequisites

* Python: 3.10-3.11
* Git

### Installation

#### Installation from source

**Step 1: Install AIOS Kernel**

Git clone AIOS kernel

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

Create venv environment

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

or create conda environment

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

> We strongly recommend using [uv](https://github.com/astral-sh/uv) for faster and more reliable package installation. 
>
> To install uv: 
>
> ```
> pip install uv
> ```

**For GPU environments:**

```bash
uv pip install -r requirements-cuda.txt
```

**For CPU-only environments:**

```bash
uv pip install -r requirements.txt
```

Alternatively, if you prefer using pip:

**For GPU environments:**

```bash
pip install -r requirements-cuda.txt
```

**For CPU-only environments:**

```bash
pip install -r requirements.txt
```

**Step 2: Install AIOS SDK (Cerebrum)**

1. Clone the Cerebrum repository:

   ```bash
   git clone https://github.com/agiresearch/Cerebrum.git
   ```
2. Install using uv (recommended):

   ```bash
   cd Cerebrum && uv pip install -e .
   ```

   Or using pip:

   ```bash
   cd Cerebrum && pip install -e .
   ```

{% hint style="success" %}
**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.
{% endhint %}

Then you can follow the instructions in the [Quickstart](https://docs.aios.foundation/aios-docs/getting-started/quickstart) to launch AIOS.