{"id":25565803,"url":"https://github.com/i-am-bee/beeai-framework-starter","last_synced_at":"2025-03-23T01:04:34.286Z","repository":{"id":257876656,"uuid":"859321348","full_name":"i-am-bee/beeai-framework-starter","owner":"i-am-bee","description":"Template to quickly start working with Bee Agent Framework.","archived":false,"fork":false,"pushed_at":"2025-03-19T20:04:32.000Z","size":396,"stargazers_count":100,"open_issues_count":0,"forks_count":29,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-03-19T21:27:01.089Z","etag":null,"topics":["agents","ai","bee-agent-framework"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"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":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-18T13:18:59.000Z","updated_at":"2025-03-19T20:04:36.000Z","dependencies_parsed_at":"2024-12-09T16:25:54.841Z","dependency_job_id":"28ca44cf-fb89-4dc9-b406-8dc413cf20e1","html_url":"https://github.com/i-am-bee/beeai-framework-starter","commit_stats":{"total_commits":71,"total_committers":6,"mean_commits":"11.833333333333334","dds":"0.11267605633802813","last_synced_commit":"52a2f9305b8fcc97e7b512bbb44b19cd2169a461"},"previous_names":["i-am-bee/bee-agent-framework-starter","i-am-bee/beeai-framework-starter"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-framework-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-framework-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-framework-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-framework-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/i-am-bee","download_url":"https://codeload.github.com/i-am-bee/beeai-framework-starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245040689,"owners_count":20551308,"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":["agents","ai","bee-agent-framework"],"created_at":"2025-02-20T22:09:38.414Z","updated_at":"2025-03-23T01:04:34.267Z","avatar_url":"https://github.com/i-am-bee.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐝 BeeAI Framework Starter\n\nThis starter template lets you quickly start working with the [BeeAI Framework](https://github.com/i-am-bee/beeai-framework) in a second.\n\n📚 See the [documentation](https://i-am-bee.github.io/beeai-framework/) to learn more.\n\n## ✨ Key Features\n\n- 🔒 Safely execute an arbitrary Python Code via [Bee Code Interpreter](https://github.com/i-am-bee/bee-code-interpreter).\n- 🔎 Get complete visibility into agents' decisions using our MLFlow integration thanks to [Bee Observe](https://github.com/i-am-bee/bee-observe).\n- 🚀 Fully fledged TypeScript project setup with linting and formatting.\n\n## 📦 Requirements\n\n- JavaScript runtime [NodeJS \u003e 18](https://nodejs.org/) (ideally installed via [nvm](https://github.com/nvm-sh/nvm)).\n- Container system like [Rancher Desktop](https://rancherdesktop.io/), [Podman](https://podman.io/) (VM must be rootfull machine) or [Docker](https://www.docker.com/).\n- LLM Provider either external [WatsonX](https://www.ibm.com/watsonx) (OpenAI, Groq, ...) or local [ollama](https://ollama.com).\n\n## 🛠️ Getting started\n\n1. Clone this repository or [use it as a template](https://github.com/new?template_name=beeai-framework-starter\u0026template_owner=i-am-bee).\n2. Install dependencies `npm ci`.\n3. Configure your project by filling in missing values in the `.env` file (default LLM provider is locally hosted `Ollama`).\n4. Run the agent `npm run start src/agent.ts`\n\nTo run an agent with a custom prompt, simply do this `npm run start src/agent.ts \u003c\u003c\u003c 'Hello Bee!'`\n\n🧪 More examples can be found [here](https://github.com/i-am-bee/beeai-framework/blob/main/examples).\n\n\u003e [!TIP]\n\u003e\n\u003e To use Bee agent with [Python Code Interpreter](https://github.com/i-am-bee/bee-code-interpreter) refer to the [Code Interpreter](#code-interpreter) section.\n\n\u003e [!TIP]\n\u003e\n\u003e To use Bee agent with [Bee Observe](https://github.com/i-am-bee/bee-observe) refer to the [Observability](#observability) section.\n\n## 🏗 Infrastructure\n\n\u003e [!NOTE]\n\u003e\n\u003e Docker distribution with support for _compose_ is required, the following are supported:\n\u003e\n\u003e - [Docker](https://www.docker.com/)\n\u003e - [Rancher](https://www.rancher.com/) - macOS users may want to use VZ instead of QEMU\n\u003e - [Podman](https://podman.io/) - requires [compose](https://podman-desktop.io/docs/compose/setting-up-compose) and **rootful machine** (if your current machine is rootless, please create a new one, also ensure you have enabled Docker compatibility mode).\n\n## 🔒Code interpreter\n\nThe [Bee Code Interpreter](https://github.com/i-am-bee/bee-code-interpreter) is a gRPC service that an agent uses to execute an arbitrary Python code safely.\n\n### Instructions\n\n1. Start all services related to the [`Code Interpreter`](https://github.com/i-am-bee/bee-code-interpreter) `npm run infra:start --profile=code_interpreter`\n2. Run the agent `npm run start src/agent_code_interpreter.ts`\n\n\u003e [!NOTE]\n\u003e\n\u003e Code Interpreter runs on `http://127.0.0.1:50081`.\n\n## 🔎 Observability\n\nGet complete visibility of the agent's inner workings via our observability stack.\n\n- The [MLFlow](https://mlflow.org/) is used as UI for observability.\n- The [Bee Observe](https://github.com/i-am-bee/bee-observe) is the observability service (API) for gathering traces from [Bee Agent Framework](https://github.com/i-am-bee/beeai-framework).\n\n### Instructions\n\n1. Start all services related to [Bee Observe](https://github.com/i-am-bee/bee-observe) `npm run infra:start --profile=observe`\n2. Run the agent `npm run start src/agent_observe.ts`\n3. See visualized trace in MLFlow web application [`http://127.0.0.1:8080/#/experiments/0`](http://localhost:8080/#/experiments/0)\n\n\u003e [!TIP]\n\u003e\n\u003e Configuration file is [infra/observe/.env.docker](./infra/observe/.env.docker).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi-am-bee%2Fbeeai-framework-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fi-am-bee%2Fbeeai-framework-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi-am-bee%2Fbeeai-framework-starter/lists"}