Cross-Platform Download & Install Center

Get AI Friend for Your Platform

You don't need to clone the full repository to run your friend. Download the compact 4.3 MB standalone runtime bundle or run the 1-line automated installer. Fully model-agnostic, MIT licensed, and 100% local.

Method 1 (Recommended)

Automated One-Line Installer

Downloads the lightweight runtime and installs the global 'friend' CLI.

● Auto-Detected Recommended
Terminal (Bash/Zsh)
$curl -fsSL https://raw.githubusercontent.com/PALabs-v1/AI_friend/main/scripts/install.sh | bash
1. Prerequisites

Requires macOS 13+, Docker Desktop, and Python 3.11+.

2. Lightweight Runtime

Downloads only the compact 4.3 MB runtime package without cloning the full repository.

3. Interactive Setup

Guided setup wizard configures your credentials and chosen local/cloud model interactively.

Method 2

Standalone Runtime Packages (4.3 MB)

Zero website source, zero benchmark logs — contains only runtime orchestration, CLI wizards, and config templates.

Compact Size: ~4.3 MB
macOS & Linux4.3 MB

Standalone Runtime Archive

Includes start.sh, friend CLI, compose files, and voice provisioners.

Download .tar.gz (4.3 MB)SHA-256 Verified · MIT License
Windows 10/114.4 MB

Windows Standalone Zip

Includes start.bat double-click launcher, start.ps1, and compose files.

Download .zip (4.4 MB)SHA-256 Verified · MIT License
Developer MonorepoFull Repo

Full Source & Evals

Complete repository with website, empirical benchmark harnesses, and academic eval probes.

Full Source (.tar.gz)Includes website & test harnesses
Tooling & Control

The Model-Agnostic 'friend' CLI

Installed in ~/.local/bin/friend
friend start

Starts the 9-agent mesh with preflight healthchecks.

friend init

Interactive wizard to configure credentials, companion name, and model.

friend talk

Opens instant terminal text conversation REPL.

friend status

Scans memory, VRAM, and Docker container health.

Have questions about GPU passthrough, Docker setup, or hardware tuning?