Getting started with BeeAI on your system
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.
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.
Install BeeAI
Start the BeeAI platform
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:
You can re-run this command anytime to change the LLM provider.
Check that everything works
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.
Updating
Upgrade BeeAI
Restart the BeeAI platform
Done!
BeeAI platform is updated.
Uninstalling
Remove the BeeAI platform instance
Uninstall the BeeAI platform
Done!
BeeAI platform is now fully removed.