all-agentic-architectures

环境要求

• Python 环境（README 用 python -m venv 创建虚拟环境）
• pip（用于安装 agentic-architectures 及其可选依赖）
• 至少一个 LLM 供应商的 API Key（如 NEBIUS_API_KEY，项目无 mock 运行）
• git（用于克隆仓库）

安装与启动步骤

1. 1克隆仓库

   从 GitHub 拉取源码并进入项目目录，后续所有命令都在该目录执行。

   git clone https://github.com/FareedKhan-dev/all-agentic-architectures
   cd all-agentic-architectures

   复制

2. 2创建虚拟环境

   在项目根目录创建 .venv，避免污染全局 Python 环境。

   python -m venv .venv

   复制

3. 3激活虚拟环境

   Windows 用第一条，macOS/Linux 用第二条，激活后再装依赖。

   .venv\Scripts\activate
   source .venv/bin/activate

   复制

4. 4安装依赖

   以可编辑模式安装 dev、test、docs 及 nebius/faiss/tavily/networkx 可选依赖。

   pip install -e ".[dev,test,docs,nebius,faiss,tavily,networkx]"

   复制

5. 5配置环境变量

   复制示例配置为 .env，再填入 NEBIUS_API_KEY 等密钥。注意 .env 不要提交。

   cp .env.example .env

   复制

6. 6运行测试

   验证安装是否完整，README 称 283 个测试约 30 秒内全部通过。

   pytest -q

   复制

7. 7跑第一个架构

   用统一 .run(task) 接口调用 Reflection，打印输出与得分。

   from agentic_architectures import get_llm
   from agentic_architectures.architectures import Reflection
   
   arch = Reflection(llm=get_llm(), max_iterations=2, target_score=8)
   result = arch.run("Write a haiku about a glacier.")
   
   print(result.output)
   print("score:", result.metadata["final_score"], "/ 10")

   复制

关键配置

如何确认成功

pytest -q 输出 283 个测试通过（约 30 秒）；或运行 Reflection 示例后打印出 haiku 正文与 score。

常见问题

注意事项

• windows 与 macOS/Linux 的虚拟环境激活命令不同，命令不可混用。
• 项目主体是 Jupyter Notebook，每个架构附带已真实执行的 notebook，理论说明基于实际运行结果。
• 仓库提供 17 项基准任务与排行榜，可用于横向对比架构表现。
• 也可通过 GitHub Codespaces 在线打开项目，免本地环境配置。