{"id":20471926,"url":"https://github.com/i-am-bee/bee-stack","last_synced_at":"2025-03-21T23:08:06.247Z","repository":{"id":258281748,"uuid":"871241679","full_name":"i-am-bee/bee-stack","owner":"i-am-bee","description":"Run the entire bee application stack using docker-compose","archived":false,"fork":false,"pushed_at":"2025-02-05T12:44:55.000Z","size":237,"stargazers_count":152,"open_issues_count":25,"forks_count":39,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-03-14T01:11:06.920Z","etag":null,"topics":["aiagent","docker-compose"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/i-am-bee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-11T14:48:01.000Z","updated_at":"2025-03-10T00:45:29.000Z","dependencies_parsed_at":"2024-11-11T14:30:50.050Z","dependency_job_id":"a095e0ea-9bc5-4da5-97ee-da081d58195b","html_url":"https://github.com/i-am-bee/bee-stack","commit_stats":null,"previous_names":["i-am-bee/bee-stack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbee-stack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbee-stack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbee-stack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbee-stack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/i-am-bee","download_url":"https://codeload.github.com/i-am-bee/bee-stack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244880608,"owners_count":20525513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiagent","docker-compose"],"created_at":"2024-11-15T14:17:37.180Z","updated_at":"2025-03-21T23:08:06.241Z","avatar_url":"https://github.com/i-am-bee.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [!WARNING]  \n\u003e \n\u003e This repository has been archived and is no longer actively maintained or updated. It is provided here for historical reference and may contain outdated or unsupported code. Users are encouraged to fork or adapt the contents as needed, but please note that no further updates, bug fixes, or security patches will be applied by the original maintainers.\n\n# 🐝 Bee Stack\n\n![Bee Stack Demo Video](https://media.githubusercontent.com/media/i-am-bee/bee-stack/refs/heads/assets/docs/assets/bee-stack-demo.gif)\n\nThe Bee Stack repository provides everything you need to run the Bee Application Stack locally using **Docker Compose**. This setup allows you to run, test, and experiment with Bee's various components seamlessly.\n\n## 🧩 Bee Stack Components\n\nThe Bee Stack comprises the following components, each contributing distinct functionalities to support your AI-driven applications:\n\n- [bee-agent-framework](https://github.com/i-am-bee/bee-agent-framework) gives the foundation to build LLM Agents.\n- [bee-code-interpreter](https://github.com/i-am-bee/bee-code-interpreter) runs a user or generated Python code in a sandboxed environment.\n- [bee-api](https://github.com/i-am-bee/bee-api) exposes agents via OpenAPI compatible Rest API.\n- [bee-ui](https://github.com/i-am-bee/bee-ui) allows you to create agents within your web browser.\n- [bee-observe](https://github.com/i-am-bee/bee-observe) and [bee-observe-connector](https://github.com/i-am-bee/bee-observe-connector) help you to trace what you are agents are doing.\n\n![architecture](https://raw.githubusercontent.com/i-am-bee/bee-stack/refs/heads/assets/docs/assets/architecture.svg)\n\n## 🔧 Pre-requisities\n**[Docker](https://www.docker.com/)** or similar container engine including docker\ncompose ([Rancher desktop](https://docs.rancherdesktop.io/) or [Podman](https://podman.io/))\n\u003e ⚠️ IMPORTANT: Make sure your VM has at least 8GB of RAM configured\n\n\u003e ⚠️ Warning: A **rootless machine is not supported** (e.g. if you use podman,\n\u003e [set your VM to rootful](https://docs.podman.io/en/stable/markdown/podman-machine-set.1.html#examples))\n\n## 🏃‍♀️ Usage\n\n### Inital setup\n```shell\ngit clone https://github.com/i-am-bee/bee-stack.git\ncd bee-stack\n# Run setup script to configure LLM provider and start the stack\n./bee-stack.sh setup\n```\n\n\n### Commands\nYou can use the following commands\n```shell\n./bee-stack.sh start # start the stack (this can take a while)\n./bee-stack.sh stop  # stop the stack without removing data\n./bee-stack.sh clean # remove data\n./bee-stack.sh setup # reconfigure (e.g. to switch LLM provider)\n```\nOnce started you can find use the following URLs:\n\n- bee-ui: http://localhost:3000\n- mlflow: http://localhost:8080\n- bee-api: http://localhost:4000 (for direct use of the api, use apiKey `sk-testkey`)\n- list all open ports: `docker compose ps --format \"{{.Names}}: {{.Ports}}\"`\n\n##  ⛓️‍💥 Troubleshooting\nPlease see our [troubleshoting guide](docs/troubleshooting.md) for help with the most common issues.\n\n\u003e If you run through the troubleshooting guide and bee-stack is still crashing, please collect\n\u003e the logs using `./bee-stack.sh logs` and submit them to a new issue at:\n\u003e https://github.com/i-am-bee/bee-agent-framework/issues/new?template=run_stack_issue.md\n\n## 👷 Advanced\n\n### Custom models\nTo create a bee with a custom model other than the default for the provider, you can use the API \nthrough [bee-python-sdk](https://github.com/i-am-bee/bee-python-sdk) or directly:\n\n```shell\ncurl -X POST \\\n  \"${BEE_API:-localhost:4000}/v1/assistants\" \\\n  -H \"Authorization: Bearer ${BEE_API_KEY:-sk-proj-testkey}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"my bee with a custom model\",\n    \"model\": \"meta-llama/llama-3-1-8b-instruct\"\n  }'\n```\nYou can then find edit the bee in the UI (assign tools, role, etc.)\n\n### Update user's name\n\n```shell\ncurl -X PUT \\\n  \"http://localhost:4000/v1/users\" \\\n  -H \"Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ0ZXN0IiwicHJlZmVycmVkX3VzZXJuYW1lIjoiVGVzdCBVc2VyIiwiZW1haWwiOiJ0ZXN0QGVtYWlsLmNvbSIsImlhdCI6MTUxNjIzOTAyMiwiaXNzIjoiaHR0cHM6Ly9sb2NhbGhvc3QiLCJhdWQiOiJiZWUtdGVzdCJ9.vwkGnl7lBbzJYk6BtoW3VoA3mnNJVI-nDQU8aK7zOH-rkf2pn5cn6CKwpq7enDInIXro8WtBLNZP8Nr8GQIZKahICuP3YrPRmzv7YIW8LuXKnx1hycg5OAtj0OtQi5FYwwCxTYW9pBF2it7XwQSBcW7yYsOrvgs7jVhThCOsavX0YiAROxZIhk1idZT4Pl3egfUI_dy9iBxcn7xocTnos-94wqJNt8oCVgB8ynj75yJFHJbiQ-9Tym_V3LcMHoEyv67Jzie8KugCgdpuF6EbQqcyfYJ83q5jJpR2LiuWMuGsNSbjjDY-f1vCSMo9L9-R8KFrDylT_BzLvRBswOzW7A\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"John Doe\"\n  }'\n```\n\n*Note: the JWT token refers to a value of DUMMY_JWT_TOKEN env specified in docker-compose.yml file* \n\n### Manual configuration\n\nIf the setup script is not working for you (e.g. you don't have bash installed), you can\nconfigure `.env` manually, have a look at [example.env](example.env) file.\n\n\u003e ⚠️ Warning: If you change providers, the default bee will stop working, because it is configured with a model from the previous provider. You should create a new Bee or remove all data using `docker compose --profile all down --volumes`.\n\n### Advanced docker compose commands\nYou can use any typical compose commands to inspect the state of the services:\n```shell\n# Docker\ndocker compose ps\ndocker compose logs bee-api\n\n# Podman\npodman compose ps\npodman compose logs bee-api\n```\n\n### For developers\nIf you are a developer on `bee-api` or `bee-ui` and want to run only the supporting infrastructure,\nuse the profile `infra`, e.g.:\n\n```shell\n./bee-stack.sh start:infra\n```\n\n## Contribution guidelines\n\nThe Bee Agent Framework is an open-source project and we ❤️ contributions.\n\nIf you'd like to contribute to Bee, please take a look at our [contribution guidelines](./CONTRIBUTING.md).\n\n## Contributors\n\nSpecial thanks to our contributors for helping us improve Bee Agent Framework.\n\n\u003ca href=\"https://github.com/i-am-bee/bee-stack/graphs/contributors\"\u003e\n  \u003cimg alt=\"Contributors list\" src=\"https://contrib.rocks/image?repo=i-am-bee/bee-stack\" /\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi-am-bee%2Fbee-stack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fi-am-bee%2Fbee-stack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi-am-bee%2Fbee-stack/lists"}