Installation Guide

System requirements and installation instructions for IfAI.

System Requirements

macOS

• OS: macOS 11 (Big Sur) or later
• Architecture: x64 or Apple Silicon (M1/M2/M3)
• RAM: 4 GB minimum, 8 GB recommended
• Disk: 500 MB for application

Windows

• OS: Windows 10 or later (64-bit)
• RAM: 4 GB minimum, 8 GB recommended
• Disk: 500 MB for application

Linux

• OS: Any modern distribution (Ubuntu 20.04+, Fedora 35+, Debian 11+)
• RAM: 4 GB minimum, 8 GB recommended
• Disk: 500 MB for application

Installation Methods

Method 1: Download from GitHub

1. Go to Releases
2. Download the appropriate file for your OS
3. Install according to your platform below

Method 2: Homebrew (macOS/Linux)

brew install --cask ifai

Method 3: AUR (Arch Linux)

yay -S ifai

Platform-Specific Instructions

macOS

DMG Installation:

1. Download IfAI-x.x.x.dmg
2. Open the DMG file
3. Drag IfAI to Applications folder
4. Launch from Applications or Spotlight

First Launch: If you see "unidentified developer" warning:

# Right-click the app and select "Open"
# Or allow in System Preferences > Security & Privacy

Windows

Installer:

1. Download IfAI-setup-x.x.x.exe
2. Run the installer
3. Follow the installation wizard
4. Launch from Start Menu or desktop shortcut

Portable Version:

1. Download IfAI-win-x.x.x.zip
2. Extract to any folder
3. Run IfAI.exe

Linux

AppImage (Universal):

chmod +x ifai-x.x.x.AppImage
./ifai-x.x.x.AppImage

Debian/Ubuntu:

sudo dpkg -i ifai-x.x.x.deb
sudo apt-get install -f  # Fix dependencies

Fedora/RHEL:

sudo dnf install ifai-x.x.x.rpm

Arch Linux (AUR):

yay -S ifai

Verifying Installation

Launch IfAI and check:

┌─────────────────────────────────────────────────────────┐
│  IfAI                                                  │
│  Version 0.3.0                                        │
│                                                         │
│  ✓ System check passed                                │
│  ✓ Editor ready                                       │
│  ✓ AI providers configured                            │
└─────────────────────────────────────────────────────────┘

Troubleshooting

"App can't be opened" (macOS)

Solution:

# Allow app from terminal
xattr -cr /Applications/IfAI.app

"Missing dependencies" (Linux)

Ubuntu/Debian:

sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils libatspi2.0-0 libuuid1 libappindicator3-1 libsecret-1-0

Fedora:

sudo dnf install gtk3 libnotify nss libXScrnSaver libXtst xdg-utils at-spi2-atk libuuid libappindicator-gtk3 libsecret

"Windows Defender blocks download"

Solution:

1. Go to Windows Security > Virus & threat protection
2. Click "Allowed threats"
3. Add IfAI to exclusions

Installation fails with "not enough disk space"

Solution:

• Free up at least 1 GB of disk space
• Try installing to a different drive

Uninstalling

macOS

# Delete app and preferences
rm -rf /Applications/IfAI.app
rm -rf ~/Library/Application\ Support/IfAI
rm -rf ~/Library/Preferences/com.ifai.app.plist

Windows

# Use Settings > Apps > Installed Apps
# Or run uninstaller from Control Panel

Linux

# Debian/Ubuntu
sudo dpkg -r ifai

# Fedora
sudo dnf remove ifai

# Arch
yay -R ifai

# Manual cleanup
rm -rf ~/.config/IfAI

Next Steps

• Getting Started - First launch guide
• AI Chat Guide - Configure AI providers
• Local LLM Setup - Run AI locally