Quickstart

Get a running instance in minutes and explore pre-built agents

Prerequisites

• Basic terminal/command line experience
• LLM API key (OpenAI, Anthropic, Gemini, watsonx, or free via OpenRouter / Groq) or Ollama (requires a powerful computer)
• Fast internet (2–3GB download)

Installation

Linux & macOS

One-Line Install

Open the terminal and run this command to install Agent Stack:

sh -c "$(curl -LsSf https://raw.githubusercontent.com/i-am-bee/agentstack/install/install.sh)"

This interactive script installs Agent Stack CLI, downloads and starts the platform, prompts you to configure your LLM API key, then launches the web interface.

Manual Install

1. Install uv

   Follow the installation instructions.

2. Linux only: Install QEMU

   Install QEMU via package manager (instructions).

3. Install Agent Stack

   Open a new terminal and run:

   uv python install --quiet --python-preference=only-managed --no-bin 3.13 && uv tool install --refresh --force --python-preference=only-managed --python=3.13 agentstack-cli && agentstack self install
   

   Follow the interactive prompts to finish installation and setup.

Windows

Windows support is experimental and requires Windows 11 22H2 or later. For the best experience, we recommend Linux or macOS.

1. Install WSL

   Open PowerShell as Administrator and run:

   wsl.exe --update
   

   Follow the instructions displayed, if any, and continue by running:

   wsl.exe --install
   

   The command output may instruct you to restart your PC. Do so, and afterwards run the same command again. It may take up to two restarts to complete the installation process.

   WSL is properly set up once you reach a working Linux shell. You can verify this by running wsl.exe without arguments. Once you have a working shell, you can close it and proceed to the next step.

   Even though WSL2 is required, Agent Stack CLI can’t be installed inside WSL2. All subsequent commands should be run from Windows PowerShell.

2. Install uv

   Open PowerShell and run:

   Installation script (recommended)

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

   Winget

   winget install astral-sh.uv
   uv tool update-shell
   

   Scoop

   scoop install uv
   uv tool update-shell
   

   Chocolatey

   choco install uv
   uv tool update-shell
   

   Close and reopen your terminal after installation.

3. Configure Ollama (optional)

   If you plan to use Ollama, we recommend installing the Windows app.

   In the Ollama app settings, it’s necessary to enable “Expose Ollama to the network” in order for it to be accessible by Agent Stack. After enabling this option, you may get a firewall prompt where you need to select “Allow”.

4. Configure local agents

   Run in PowerShell:

   setx HOST 0.0.0.0
   

   Close and reopen your terminal after this.

   This will make local agents accessible over the local network, which is needed for Agent Stack to access them. When running local agents, you may encounter firewall prompts where you need to select “Allow”.

5. Install Agent Stack

   uv python install --quiet --python-preference=only-managed --no-bin 3.13; uv tool install --refresh --force --python-preference=only-managed --python=3.13 agentstack-cli; agentstack self install
   

   Follow the interactive prompts to finish the installation and setup.

Usage

agentstack ui                     # Launch web interface
agentstack list                   # See what agents are available
agentstack run chat "Hi!"         # Send a message to chat agent
agentstack run chat               # Try interactive mode
agentstack info chat              # View agent details
agentstack --help                 # See all options

Platform Management

agentstack platform start        # Start platform
agentstack model setup           # Configure LLM provider
agentstack platform stop         # Stop (keeps data)
agentstack platform delete       # Delete all data

Version & Upgrades

If you are having issues with these commands, you may be running an old version of Agent Stack. Run the one-line install script above to upgrade to the latest version.

agentstack self version          # Check version
agentstack self upgrade          # Update
agentstack self uninstall        # Remove completely