beeai-framework

环境要求

• Python 环境（用于安装 beeai-framework 的 Python 包）
• 已安装 pip（Python 包管理工具）
• 可选：Node.js/npm 环境（若使用 TypeScript 版本）
• 已安装 ollama，并下载 granite4.1:8b 模型（运行 README 示例所需）

安装与启动步骤

1. 1安装 Python 库

   在终端执行 pip 安装命令，把 beeai-framework 安装到当前 Python 环境；建议先激活虚拟环境，避免污染全局环境。

   pip install beeai-framework

   复制

2. 2安装 TypeScript 库

   只有使用 TypeScript 版本时才需要执行；在 Node 项目目录下用 npm 安装同名包。只用 Python 可跳过此步。

   npm install beeai-framework

   复制

3. 3准备本地模型

   README 示例依赖 ollama，需先安装 ollama 并下载 granite4.1:8b 模型，模型未就绪会导致示例无法运行。

4. 4运行示例脚本

   进入示例脚本所在目录，用 python 执行脚本文件；把 your_agent.py 换成你自己的脚本名。

   python your_agent.py

   复制

5. 5查看更多示例

   README 指向 Python 与 TypeScript 的 examples 目录，里面有更完整的智能体与多智能体示例可供参考。

如何确认成功

python 执行示例脚本时不再报 ModuleNotFoundError，并能正常调用本地 ollama 模型返回结果，即表示环境安装成功。

常见问题

注意事项

• README 的示例前提是已安装 ollama 并下载 granite4.1:8b 模型，缺一不可。
• 仓库分 Python 与 TypeScript 两套实现，安装目录与示例目录均为 python/ 与 typescript/ 两个子目录。
• 建议在虚拟环境中安装，避免与其他项目的依赖版本冲突。