Bee stack

This repository will help you run the entire bee application stack locally through docker compose. This includes the following bee components along with the supporting infrastructure:

• bee-agent-framework
• bee-code-interpreter
• bee-api
• bee-ui
• bee-observe and bee-observe-connector

Pre-requisities 🔧

Docker or similar container engine including docker compose (Rancher desktop or Podman)

⚠️ Warning: A rootless machine is not supported (e.g. if you use podman, set your VM to rootful)

Usage 🏃‍♀️

1. Clone this repository

git clone https://github.com/i-am-bee/bee-stack.git
cd bee-stack

2. Configure environment and fill required variables

cp example.env .env
vim .env # fill in your API key

3. Up! (this might take a while the first time you run it)

docker compose --profile all up -d

Once started you can find use the following URLs:

• bee-ui: http://localhost:3000
• mlflow: http://localhost:8080
• bee-api: http://localhost:4000 (for direct use of the api, use apiKey sk-testkey)
• list all open ports: docker compose ps --format "{{.Names}}: {{.Ports}}"

You can use any typical compose commands to inspect the state of the services:

docker compose ps
docker compose logs bee-api

Stopping services:

# Stop all
docker compose --profile all down

# Stop all and remove data
docker compose --profile all down --volumes

Advanced 👷

If you are a developer on bee-api or bee-ui and want to run only the supporting infrastructure, use the profile infra, e.g.:

docker compose --profile infra up -d

Contributing

This is an open-source project and we ❤️ contributions.

If you'd like to contribute to Bee, please take a look at our contribution guidelines.