Getting Started with IfAI

Welcome to IfAI! This guide will help you get up and running in minutes.

What is IfAI?

IfAI is an AI-native code editor designed for the future of software development. Unlike traditional editors that bolt on AI features, IfAI is built from the ground up with AI at its core.

Key Features

• 🤖 AI Chat Panel - Natural language interface for coding assistance
• 🎹 Composer - Multi-file AI-powered editing
• 🔍 Code Intelligence - Go to Definition, Find References for 35+ languages
• 🔄 AI Refactoring - Automatic code quality improvements
• 🦥 Local LLM Support - Run AI models locally with Ollama

Installation

Download

1. Visit GitHub Releases
2. Download the latest version for your OS:
   • macOS: IfAI.dmg
   • Windows: IfAI-setup.exe
   • Linux: ifai.AppImage

Install

macOS:

# Open the DMG and drag IfAI to Applications

Windows:

# Run the installer
IfAI-setup.exe

Linux:

# Make AppImage executable and run
chmod +x ifai.AppImage
./ifai.AppImage

First Launch

When you first open IfAI, you'll see:

┌─────────────────────────────────────────────────────────┐
│  Welcome to IfAI!                                      │
│                                                         │
│  [ ] Show tour on startup                              │
│                                                         │
│  [Start Tour]  [Skip]                                  │
└─────────────────────────────────────────────────────────┘

Interactive Tour

The tour will guide you through:

1. AI Chat - Your AI programming assistant
2. File Tree - Navigate your project
3. Monaco Editor - Write code with AI assistance
4. Inline AI - Quick edits with Cmd+K

Opening Your First Project

1. Click Open Project or press Cmd+O
2. Select your project folder
3. IfAI will index your code automatically

AI Configuration

Cloud AI Providers

For the best experience, configure an AI provider:

OpenAI:

1. Open Settings (Cmd+,)
2. Go to AI Provider > OpenAI
3. Enter your API key

Anthropic Claude:

1. Open Settings (Cmd+,)
2. Go to AI Provider > Anthropic
3. Enter your API key

Zhipu AI (智谱):

1. Open Settings (Cmd+,)
2. Go to AI Provider > Zhipu
3. Enter your API key

Local LLM (Optional)

For privacy and cost savings:

1. Install Ollama
2. Download a model:

   ollama pull qwen2.5-coder

3. In IfAI Settings, select Ollama as provider

Your First AI Chat

Let's write some code with AI!

1. Open a file or create a new one
2. Press Cmd+K to open AI Chat
3. Try a prompt:

   Create a React component for a user profile card

AI will generate code and insert it into your editor.

Next Steps

• Basic Usage - Learn core features
• AI Chat Guide - Master AI conversations
• Composer Guide - Multi-file editing
• Keyboard Shortcuts - Speed up your workflow

Getting Help

• Documentation: https://github.com/peterfei/ifai/tree/main/docs
• GitHub Issues: https://github.com/peterfei/ifai/issues
• Discussions: https://github.com/peterfei/ifai/discussions

---

Happy coding with IfAI! 🚀