BeeAI can be installed and used locally through the BeeAI CLI. Internally, this creates an automatically managed virtual machine for running agents. We offer support for macOS, Linux and Windows.

BeeAI requires macOS 13 (Ventura) or later.

1

Install uv

If you don’t have uv installed, install it using one of the supported ways.

Open a terminal and run:

After this, close the terminal and re-open it.

2

Install BeeAI

uv tool install beeai-cli
3

Start the BeeAI platform

beeai platform start
4

Configure an LLM provider

BeeAI needs an LLM provider for the agents — like OpenAI, Ollama, Anthropic, etc.

If you don’t already have an API key for a provider, you can register for a free one on OpenRouter.

Run this command and follow the interactive prompts:

beeai env setup

You can re-run this command anytime to change the LLM provider.

5

Check that everything works

beeai run chat Hi!

Starting up an agent for a first time may take a few minutes. If everything is succesful, you should see a friendly greeting from the agent.

✨ Done! You are ready to use the BeeAI platform.