Installation Guide

Get CLIO up and running on your system

System Requirements

Operating System

• macOS: 10.14 (Mojave) or later
• Linux: Any modern distribution (Ubuntu 18.04+, Debian 10+, Fedora 30+, Arch)
• Windows: Via WSL (Windows Subsystem for Linux)

Required Software

Perl 5.32 or higher (usually pre-installed on macOS and Linux)

# Check your Perl version
perl --version

Git - Required for version control operations

# Check Git installation
git --version

Standard Unix Tools: curl, rsync, ssh (for remote execution)

AI Provider Account

You need one of the following:

• GitHub Copilot (Recommended) - Subscription required (~$10/month)
• OpenAI - API account with pay-as-you-go pricing
• DeepSeek - Cost-effective code-focused AI
• OpenRouter - Access to multiple AI providers
• llama.cpp (Local) - No API key required
• SAM (Local) - Integrated with CLIO

Quick Installation

Homebrew (macOS)

brew tap SyntheticAutonomicMind/homebrew-SAM
brew install clio

Manual Installation

# 1. Clone the repository
git clone https://github.com/SyntheticAutonomicMind/CLIO.git
cd CLIO

# 2. Run installer
sudo ./install.sh

# 3. Verify installation
clio --version

Configuration

GitHub Copilot (Recommended)

# Start CLIO
clio

# Inside CLIO, login:
: /api login
# Follow browser prompts to authorize with GitHub

OpenAI or Other Providers

# Start CLIO
clio

# Configure provider:
: /api set provider openai
: /api set key YOUR_API_KEY
: /api set model gpt-4o
: /config save

First Run

# Start a new session
clio --new

# Or continue previous session
clio

Next Steps

• Quick Start Guide - Your first CLIO session
• AI Providers - Detailed provider configuration
• Slash Commands - Command reference