Install AIPACK

Here’s how to install AIPACK on all platforms.

• First, install the aip command-line tool using the instructions below: Mac, Linux, Windows.

• Then, edit the AIPACK base config file at ~/.aipack-base/config.toml to set your default model.

Look for this line and edit it with the model name or model alias (shown below in the TOML) that you want.

NOTE: This will be the default model name used if the workspace (.aipack/config.toml) or agent does not specify one.

model = "gpt-4.1-mini" # or an alias from below (e.g., "flash", "gpro")

NOTE: (Optional) If you’re using VSCode, consider installing the AIPACK VSCode extension. It ensures the correct file association.

If you’re not using the AIPACK VSCode extension, mapping the .aip file extension to markdown provides relevant syntax highlighting, since .aip files are essentially markdown files.

Environment Variables

The aip run ... commands require the appropriate model provider API keys to be set.

Here are the environment variables supported by default:

OPENAI_API_KEY
ANTHROPIC_API_KEY
GEMINI_API_KEY
XAI_API_KEY
DEEPSEEK_API_KEY
GROQ_API_KEY
COHERE_API_KEY

On Mac/Linux, set your API keys by running (make sure there are no spaces before or after the = sign):

export OPENAI_API_KEY="sk...."

On Windows PowerShell:

$env:OPENAI_API_KEY = 'YOUR_OPENAI_KEY_HERE'

Windows

NOTE: Be sure to use PowerShell on Windows

# Windows x86
Invoke-WebRequest -Uri "https://repo.aipack.ai/aip-dist/stable/latest/x86_64-pc-windows-msvc/aip.tar.gz" -OutFile "aip.tar.gz"
tar -xvf aip.tar.gz
.\aip.exe self setup

# Windows ARM
Invoke-WebRequest -Uri "https://repo.aipack.ai/aip-dist/stable/latest/aarch64-pc-windows-msvc/aip.tar.gz" -OutFile "aip.tar.gz"
tar -xvf aip.tar.gz
.\aip.exe self setup

Linux

# Linux x86
curl -O https://repo.aipack.ai/aip-dist/stable/latest/x86_64-unknown-linux-gnu/aip.tar.gz && \
        tar -xvf aip.tar.gz && \
        ./aip self setup

# Linux ARM
curl -O https://repo.aipack.ai/aip-dist/stable/latest/aarch64-unknown-linux-gnu/aip.tar.gz && \
        tar -xvf aip.tar.gz && \
        ./aip self setup

Mac

# Mac ARM / Apple Silicon
curl -O https://repo.aipack.ai/aip-dist/stable/latest/aarch64-apple-darwin/aip.tar.gz && \
        tar -xvf aip.tar.gz && \
        ./aip self setup

# Mac x86
curl -O https://repo.aipack.ai/aip-dist/stable/latest/x86_64-apple-darwin/aip.tar.gz && \
        tar -xvf aip.tar.gz && \
        ./aip self setup

Advanced Details (How the Install Works Behind the Scenes)

All these installs perform the following steps:

1. Download the aip (AIPACK command line) aip.tar.gz package.

2. Untar/unzip the aip.tar.gz into aip on Linux/Mac and aip.exe on Windows.

3. Run aip self setup, which initializes the ~/.aipack-base/ directory and copies itself to ~/.aipack-base/bin/.

4. Set up the PATH environment variable:

   • On Mac, this adds source "~/.aipack-base/bin/aip-env" to ~/.zshenv if it's not already present.
   • On Linux, it does the same in the ~/.bashrc file.
   • On Windows, it checks the user path via PowerShell and adds $HOME/.aipack-base/bin/ if it's not already present.