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