Installation

AIA is a Ruby gem that can be installed and run from the command line. Follow these steps to get started:

Prerequisites

Required

• Ruby: >= 3.2.0
• External Tools:
  • fzf - Command-line fuzzy finder (required for prompt selection)

Optional Tools

• glow - For rendering markdown output
• Various audio players for speech output (afplay on macOS is default)

Installation Steps

1. Install AIA Gem

gem install aia

2. Install Required External Tools

macOS (using Homebrew):

brew install fzf

Linux:

# Ubuntu/Debian
sudo apt install fzf

# Arch Linux
sudo pacman -S fzf

# CentOS/RHEL/Fedora
sudo dnf install fzf

3. Setup Prompts Directory

Establish a directory for your prompt text files, parameter history, and usage logs:

mkdir -p ~/.prompts
mkdir -p ~/.prompts/roles

You can change this location with the --prompts_dir option or by setting the AIA_PROMPTS_DIR environment variable.

4. Setup Shell Completion (Optional)

Get completion functions for your shell:

# For bash users
aia --completion bash >> ~/.bashrc

# For zsh users  
aia --completion zsh >> ~/.zshrc

# For fish users
aia --completion fish >> ~/.config/fish/config.fish

Then reload your shell or source the config file.

Quick Start

Create your first prompt:

echo "What is [TOPIC]?" > ~/.prompts/ask.txt

Run your prompt:

aia ask

You'll be prompted to enter a value for [TOPIC], then AIA will send your question to the AI model.

Start an interactive chat:

aia --chat

Configuration Directory

AIA creates a configuration directory at ~/.aia/ which contains:

• config.yml - Main configuration file
• Model registry cache files
• Other application data

This directory is created automatically on first run.

---

For more configuration options, see Configuration.