Skip to main content

Installation

Akio is built using the Python package and project manager uv. You can choose between a pipx installation (recommended) or install from source if you want full control.


Prerequisites

Akio use Ollama as a LLM provider by default so make sure it's installed.

You can install Ollama using:

curl -fsSL https://ollama.com/install.sh | sh

You can also install Ollama on a different machine and edit the llm_provider_base_url object in the config file at ~/.akio/settings.json.

The fastest way to get started is with pipx.

# Install pipx
apt install pipx # On Linux
brew install pipx # On macOS

# Ensure pipx is in PATH and reload the shell
pipx ensurepath && exec $SHELL

# Install akio
pipx install akio

Installation from source

git clone https://github.com/Fastiraz/akio.git
cd akio

uv build
uv venv
uv pip install dist/*.whl
uv run -- akio help

Coming soon...