Skip to main content

​
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
  • Windows

​
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/HEAD/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.
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 tool install --refresh --quiet --force agentstack-cli && agentstack self install
Follow the interactive prompts to finish 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
Explore the rest of the documentation to learn how to connect MCP servers, build your own agents, use document retrieval, and more! 🐝