atomic-agents

环境要求

• 已安装 Python 环境并可使用 pip 安装依赖包
• 使用 OpenAI 时无需额外安装 provider（默认内置）
• 可选：安装 uv，用于从克隆的仓库中运行 CLI

安装与启动步骤

1. 1安装核心包

   通过 pip 安装 atomic-agents，它会同时安装 Atomic Assembler 命令行工具，用于下载 Tools。

   pip install atomic-agents

   复制

2. 2安装所需 provider

   OpenAI 已默认内置；若要用 Groq、Anthropic、Gemini，需按需安装对应 instructor 扩展。

   pip install instructor[groq]
   pip install instructor[anthropic]
   pip install instructor[google-genai]

   复制

3. 3启动 Atomic Assembler

   直接运行 atomic 命令，会出现菜单，可按工具逐项下载；每个工具自带输入输出 schema、示例、依赖与测试。

   atomic

   复制

4. 4从仓库运行 CLI

   如果克隆了仓库并用 uv 管理环境，可改用 uv run atomic 启动同一 CLI。

   uv run atomic

   复制

5. 5运行官方示例

   examples 目录的 quickstart 下提供了可运行示例，例如基础聊天机器人脚本，可作为改造起点。

   python atomic-examples/quickstart/quickstart/1_0_basic_chatbot.py

   复制

如何确认成功

执行 pip install atomic-agents 无报错，且运行 atomic 后能看到可下载工具的菜单界面。

常见问题

注意事项

• OpenAI 集成默认内置，只有使用其他 provider 时才需要额外安装 instructor 扩展。
• 安装 atomic-agents 会一并安装 Atomic Assembler CLI，无需单独安装。
• 示例默认位于克隆仓库的 atomic-examples/quickstart/quickstart/ 目录，单独 pip 安装后不会自带这些示例文件。