SwarmAI

EN ☾ Download

SwarmAI

AI-Powered Browser Swarm Automation
Complete User Guide & Tutorial

Control dozens of mobile-sized browsers with AI agents. Each browser has a unique fingerprint, persistent sessions, and full DOM-based automation — all from one desktop app.

Version 1.0 • April 2026

1. Introduction & System Requirements

What is SwarmAI?

SwarmAI is a desktop application that manages multiple mobile-sized browser instances controlled by AI agents. Instead of writing scripts or macros, you describe what you want in natural language — the AI reads the page DOM, identifies elements, and performs clicks, typing, and scrolling automatically.

Each browser runs as a persistent Chromium context with a unique device fingerprint, making it appear as a real mobile device. Run dozens of browsers simultaneously from one desktop.

How It Works

System Requirements

2. Installation & First-Time Setup

Step 1: Download & Install

1. Download the latest installer from the SwarmAI dashboard after signing in
2. Run the installer and follow on-screen instructions
3. Launch SwarmAI from the Start Menu or desktop shortcut
4. Sign in with your Google account when the login screen appears

Step 2: Chromium Auto-Install

SwarmAI uses Playwright's Chromium. On first launch, it automatically installs the correct Chromium version. If you need to reinstall manually:

playwright install chromium

Step 3: Configure Your API Key

1. Click the Settings button (gear icon) in the top toolbar
2. Select your LLM provider (e.g., Anthropic, OpenAI)
3. Paste your API key
4. Select a model from the dropdown
5. Click Save

3. Creating Your First Browser

Creating a Browser Instance

1. Click the + Browser button in the top toolbar
2. A new mobile-sized browser appears in the browser grid
3. Each browser is assigned a unique device fingerprint automatically
4. The browser opens to the configured homepage (default: Google)

Persistent Sessions

Browser sessions are fully persistent. Cookies, logins, local storage, and history are preserved across restarts. Each browser maintains its own isolated profile.

Browser Panel Controls

4. Configuring LLM Providers & API Keys

SwarmAI requires an LLM API key to power its AI agent. The AI reads the browser DOM and decides what actions to take.

Supported Providers

Getting an API Key

Anthropic (Recommended)

1. Go to console.anthropic.com
2. Create an account or sign in
3. Navigate to API Keys in the dashboard
4. Click Create Key and copy it (starts with sk-ant-)
5. Add credits to your account (API is pay-per-use)

OpenAI

1. Go to platform.openai.com
2. Create an account or sign in
3. Navigate to API Keys
4. Click Create new secret key and copy it (starts with sk-)

Entering Your API Key

1. Click the Settings button (gear icon) in the top toolbar
2. In AI Model section, select your provider
3. Paste your API key
4. Select a model from the dropdown
5. Click Save

Using a Custom Provider

If you have an OpenAI-compatible API endpoint (e.g., local model, proxy, third-party):

1. Select Custom from the provider dropdown
2. Enter the base URL (e.g., http://localhost:11434/v1 for Ollama)
3. Enter your API key (if required)
4. Type your model name manually

5. Interface Overview

SwarmAI has a split-panel layout: Chat Panel on the left and Browser Grid on the right.

Top Toolbar

Chat Panel (Left Side)

The chat panel has four tabs:

Command Input Bar (Bottom)

6. Your First Task — Quick Start

Let's walk through your very first SwarmAI task, step by step.

Prerequisites Checklist

• ☑ SwarmAI installed and running
• ☑ Signed in with Google account
• ☑ At least one browser created (click + Browser)
• ☑ LLM API key configured in Settings

Example: Search on Google

1. Make sure a browser is selected (check the Target toggle)
2. Click the text input field at the bottom of the chat panel
3. Type: Go to google.com and search for "best AI tools 2026"
4. Press Enter (or click the Send button)
5. Watch the Activity tab — the AI will navigate to Google, type the query, and press search

More Example Commands

Stopping a Task

Click the red Stop button during execution. The AI agent will halt immediately.

7. Core Features Deep Dive

How the AI Agent Works

SwarmAI uses the browser-use library for agent logic. For each step, the agent follows this cycle:

1. Observe — Extract the page DOM, identify interactive elements
2. Think — Analyze the page state, plan the best action
3. Act — Execute one action: click, type, scroll, navigate
4. Repeat — Loop until task complete or max steps reached

Available Actions

Smart Agent Features

8. Multi-Browser Swarm Setup

SwarmAI is built for scale. Run dozens of browsers simultaneously, each with its own identity.

Creating Multiple Browsers

1. Click + Browser repeatedly to create as many browsers as needed
2. Each browser gets a unique fingerprint and CDP port automatically
3. Browsers appear in the grid, each showing a live screencast

Sending Commands to Multiple Browsers

Option 1: All Browsers

Use the Target toggle and select all browsers. Each browser gets its own independent AI agent.

Option 2: Selected Browsers

Click the selection badge on each browser to target. Commands run only on selected browsers.

Performance Considerations

9. Device Fingerprinting

SwarmAI spoofs 15 fingerprint vectors for each browser, making them appear as unique real mobile devices.

Fingerprint Vectors

Device Profiles

SwarmAI includes 25+ mobile device profiles: iPhone 15 Pro, Galaxy S24, Pixel 8, and many more. Each browser is assigned a random profile on creation.

10. Mirror Mode

Mirror Mode lets you manually control browsers using your mouse and keyboard, with all selected browsers receiving the same input simultaneously.

Enabling Mirror Mode

1. Click Mirror in the top toolbar (turns green)
2. Select the browsers you want to mirror
3. Click on any browser panel — your input is forwarded to all selected browsers

Controls in Mirror Mode

11. Loop & Repeat Mode

Loop Mode repeats the same command multiple times with optional delays between cycles. Essential for repetitive tasks like engagement, monitoring, or data collection.

Setting Up a Loop

1. Click Loop button in the command bar
2. Set Count: how many times to repeat (1-999)
3. Set Interval: minutes between cycles (0-999)
4. Type your command and send — it repeats automatically

Example: Engagement Loop

Loop: 10 cycles, 5 minute interval
Command: "Go to instagram.com, scroll feed, like 3 posts"

Result: Every 5 minutes, each browser opens Instagram,
likes 3 posts. Repeats 10 times over ~50 minutes.

12. Stealth Mode

Stealth Mode makes the AI's actions appear more human-like by introducing natural variations.

What Stealth Mode Does

When to Use Stealth Mode

• Social media automation — Prevents detection by platform algorithms
• Account management — Makes bot behavior less detectable
• Extended sessions — More natural interaction patterns

13. Presets, Personas & Rules

Saved Commands

Save frequently-used commands for one-click execution:

1. Go to Presets tab → Saved Commands
2. Enter a name and command text
3. Click Add
4. Click Play next to any saved command to execute

AI Personas

Personas customize the AI agent's behavior. Only one persona can be active at a time.

Examples: Speed Runner (fast, skip verifications), Careful (verify before/after each action), Social Media Expert (navigate social apps expertly).

AI Rules

Rules are constraints always injected into the AI's system prompt. Multiple rules can be active simultaneously.

Examples: "Never click on ads", "Always close popups first", "Use search instead of scrolling", "Skip sponsored content".

Site Cards

Site Cards provide context about specific websites to help the AI navigate more accurately. When you send a command and the browser is on a matching site, the card's instructions are injected into the system prompt.

14. Extract Mode & Data Collection

Extract Mode forces the AI agent to return structured data instead of completing a task. This is browser-use's native extraction mechanism.

How to Use Extract Mode

1. Toggle Extract ON in the command bar
2. Type a command describing what data to extract
3. The AI navigates to the data source and returns structured JSON
4. Results appear in the Extracts tab

Example

Command: "Go to reddit.com/r/technology and extract the top 10 post titles, authors, and upvote counts"

Result (in Extracts tab):
{
  "items": [
    {"title": "...", "author": "u/...", "upvotes": 1234},
    ...
  ],
  "summary": "Extracted 10 posts from r/technology"
}

15. Proxy Management

Assign unique proxy IP addresses to each browser for maximum anonymity and anti-detection.

Setting Up Proxies

1. Click Proxy in the top toolbar
2. Paste your proxy list (one per line): host:port:user:pass
3. Select assignment mode: Manual or Auto-distribute
4. Proxies are assigned to browsers and persist across sessions

Supported Proxy Types

16. Telegram Bot Remote Control

Control SwarmAI remotely from your phone using a Telegram bot. Run tasks, take screenshots, check status, and manage your browser swarm — all from Telegram chat.

Setting Up the Telegram Bot

Step 1: Create a Bot with @BotFather

1. Open Telegram on your phone or desktop
2. Search for @BotFather (official Telegram bot creator)
3. Send /newbot to start the creation process
4. Enter a display name for your bot (e.g., "My SwarmAI Bot")
5. Enter a username ending in "bot" (e.g., "my_swarmai_bot")
6. BotFather will give you a bot token — copy it. It looks like: 7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Step 2: Find Your Chat ID

1. Search for @userinfobot on Telegram
2. Send any message to it (e.g., "hello")
3. It replies with your Chat ID — a number like 123456789
4. Copy this number

Step 3: Configure in SwarmAI

1. Open SwarmAI and click Settings (gear icon)
2. Scroll down to the Telegram Bot section
3. Paste your Bot Token in the token field
4. Enter your Chat ID in the Chat ID field
5. Enable Auto-start if you want the bot to start automatically with SwarmAI
6. Click Save
7. The bot status indicator will turn green when connected

Step 4: Test the Connection

1. Open Telegram and go to your bot (search by the username you created)
2. Send /help
3. You should receive a list of available commands with a keyboard

All Telegram Commands

Usage Examples

Running a Task

You: /run Go to instagram.com and like 3 posts
Bot: ✅ Task sent to Browser #1
Bot: [Step 1] Navigating to instagram.com...
Bot: [Step 5] Task complete. Liked 3 posts.

Taking Screenshots

You: /ss
Bot: [Screenshot of Browser #1]

You: /ss all
Bot: [Screenshot of Browser #1]
Bot: [Screenshot of Browser #2]
Bot: [Screenshot of Browser #3]

Looping a Task

You: /loop 5 10 Like 3 posts on instagram.com
Bot: 🔄 Loop started: 5 cycles, 10 min interval
Bot: [Cycle 1/5] Running...
Bot: [Cycle 1/5] Done
Bot: ⏲ Next cycle in 10 minutes...

Quick Text Commands

You can also just type plain text (without /run) and the bot will treat it as a task:

You: Search for "best laptops 2026" on Google
Bot: ✅ Task sent to Browser #1

17. Settings Reference

AI Model

Agent

Display

18. Troubleshooting & FAQ

Browser Issues

AI Agent Issues

Frequently Asked Questions

Q: How much does the LLM API cost?

A typical task (10-15 steps) costs ~$0.01-0.03 with Claude Sonnet, ~$0.005-0.01 with GPT-4o-mini. Screenshots add ~$0.01-0.02 each. Token costs are shown in the status bar.

Q: Can I use SwarmAI offline?

Internet is required for LLM APIs and web browsing. You can use a local model via Ollama with the Custom provider to reduce external API dependency.

Q: How many browsers can I run?

No hard limit. Practical limits depend on RAM and CPU. Typical users run 5-30 browsers per PC.

Q: Is my API key stored securely?

API keys are stored locally in settings.json in your AppData folder. Never sent to SwarmAI servers.

Q: Do browser sessions persist?

Yes. All cookies, logins, local storage, and history are saved per browser profile and persist across app restarts.