# Task Agents Tutorial

## Installing Koii from ISO

**Running Koii as Your Primary AI Operating System**

Koii Core is distributed as a **bootable 4.2 GB ISO** — a complete, ready-to-run Artificial Intelligence Operating System. This guide walks you through installation when your current environment or download is an ISO file.

#### System Requirements

* **CPU**: 8+ cores (x86\_64 or ARM64)
* **RAM**: 32 GB minimum (64 GB+ recommended for heavy agent workloads)
* **Storage**: 100 GB SSD minimum (NVMe preferred)
* **Network**: 1 Gbps+ connection recommended
* **Boot Method**: UEFI (Legacy BIOS supported but not recommended)

#### Option 1: Boot and Run Live (No Installation)

1. Download **Koii Core v2.0 ISO** (4.2 GB) from <https://koiiai.com>
2. Create a bootable USB drive:

   ```bash
   # On Linux/macOS
   sudo dd if=koii-core-v2.0.iso of=/dev/sdX bs=4M status=progress && sync
   ```

(Replace /dev/sdX with your USB device — use lsblk to identify it) 3. Insert the USB, restart your computer, and enter BIOS/UEFI (usually F2, F10, or Del). 4. Set the USB as first boot device → Save & Exit. 5. Koii will boot into a live environment. You can test agents immediately.

**Live Mode Command**:

Bash

```
koii init
```

#### Option 2: Full Installation to Disk

After booting into the Live ISO:

1. Open terminal and launch the installer:Bash

   ```
   koii-installer
   ```

   Or run:Bash

   ```
   sudo koii install --target /dev/nvme0n1
   ```
2. Follow the guided installer:
   * Select target disk
   * Choose partitioning (automatic recommended for most users)
   * Set hostname and timezone
   * Create admin user (recommended)
   * Enable global infrastructure connection
3. Reboot after installation completes:Bash

   ```
   sudo reboot
   ```

#### Post-Installation First Steps

Bash

```
# Initialize Koii kernel and agents
koii init --config production

# Verify installation
koii status

# Create your first Task Agent
koii agent create --name "welcome-agent" --goal "Introduce me to Koii features"
```

#### Common ISO Boot Issues & Fixes

* **ISO won't boot** → Verify SHA-256 checksum from the download page.
* **Not enough RAM** → Koii Live requires at least 16 GB to boot (32 GB+ for full features).
* **Graphics issues** → Add boot parameter nomodeset in GRUB menu.
* **Network not connecting** → After boot, run koii network connect.

#### Upgrading from ISO

Bash

```
# Inside running Koii system
koii upgrade
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://koiiai.gitbook.io/koiiai-docs/main-features/task-agents-tutorial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.