dynamiq

环境要求

• Python 环境（README 明确要求先在本机装好 Python）
• pip 包管理工具（用于 pip install dynamiq）
• 若选择源码构建，需要 uv 工具（README 使用 uv sync）
• OpenAI API Key（示例中通过 OpenAIConnection 传入 api_key）

安装与启动步骤

1. 1确认 Python 环境

   README 要求本机已配置 Python 环境，先确认 python 命令可正常执行，再继续安装。

   python --version

   复制

2. 2pip 安装 dynamiq

   最简安装方式，一条命令从 PyPI 安装 Dynamiq 包，适用于绝大多数使用者。

   pip install dynamiq

   复制

3. 3源码构建安装

   需要改源码或尝鲜时可从 GitHub 克隆并用 uv 同步依赖；三条命令需依次执行。

   git clone https://github.com/dynamiq-ai/dynamiq.git
   cd dynamiq
   uv sync

   复制

4. 4配置 LLM 节点

   按 README 示例用 OpenAI 节点接入模型：填 API Key、选模型 gpt-4o，并设置温度与最大 token。

   from dynamiq.nodes.llms import OpenAI
   from dynamiq.connections import OpenAIConnection
   
   llm = OpenAI(
       id="openai",
       connection=OpenAIConnection(api_key="sk-xxxxxxxx"),
       model="gpt-4o",
       temperature=0.3,
       max_tokens=1000,
   )

   复制

5. 5运行节点验证

   用 README 示例的输入数据调用 llm.run，观察返回结果，确认安装与密钥配置都正确。

   result = llm.run(
       input_data={"text": "Hola Mundo!"}
   )
   print(result)

   复制

6. 6编排智能体工作流

   按 README 示例创建 Agent 并加入 Workflow，可用 depends 与 InputTransformer 串起多智能体顺序执行。

   wf = Workflow()
   wf.flow.add_nodes(first_agent)
   wf.flow.add_nodes(second_agent)
   
   result = wf.run(
       input_data={"input": "How are sin(x) and cos(x) connected in electrodynamics?"},
   )

   复制

关键配置

如何确认成功

执行 python -c "import dynamiq" 无报错即安装成功；再运行 README 的 llm.run 示例，能拿到模型返回内容即配置正确。

常见问题

注意事项

• API Key 不要硬编码后提交到 Git 仓库，README 示例中的 OPENAI_API_KEY 只是占位符。
• README 代码块为片段，示例中出现的 prompt 等变量需由你自己在使用前定义。
• 更多示例与详细说明见官方文档 https://dynamiq-ai.github.io/dynamiq。