安全公告 — 恶意 litellm 版本 1.82.7 与 1.82.8 已从 PyPI 移除（存在 API 密钥外泄风险）。请卸载、轮换已暴露凭据，并升级至安全版本（如 1.82.9+）。运行 pip show litellm 以确认。 PyPI · README

安装

安装 Python 包、验证 CLI，并准备 Near 或 SDK 用法。

安装

先装 Python 包。Near 桌面内嵌同一套后端；SDK 开发和本机 agx 仍然用这个包。

你在装什么

示意图：CLI 拉起 agx serve 给 Near；SDK 嵌进你的 Python 进程。

环境要求

  • Python 3.10+
  • pip 或 uv
  • 至少一个模型供应商密钥，或可访问的本机 OpenAI 兼容端点（例如 Ollama）

从 PyPI 安装

bash
1pip install agenticx

pyproject.toml 里还有可选 extras（桌面运行时、额外 LLM 适配、数据源）。按需安装即可。pip install "agenticx[all]" 会拉进很大一组可选依赖，只跑 agx serve + 单一供应商时不必装。

从源码安装

bash
1git clone https://github.com/DemonDamon/AgenticX.git
2cd AgenticX
3pip install -e .

验证

bash
1agx --version
2agx --help

应能看到 agx 命令组（serve、studio、loop、run 等）。若找不到命令，说明 console script 不在当前 PATH —— 装进你正在用的那个环境。

供应商密钥

写到环境变量或 ~/.agenticx/config.yaml。能跑通一家即可开工。

bash
1export OPENAI_API_KEY="your-key"
2# 或 ANTHROPIC_API_KEY、MINIMAX_API_KEY 等

YAML 结构见 配置。

文档解析（可选）

Studio / Near 知识入库用 LiteParse 处理 PDF、Office 文本和图片。这和模型在 shell 里自己调 pdftotext 不是一回事。

bash
1npm i -g @llamaindex/liteparse

.xlsx / .xls 需要本机 LibreOffice。macOS：brew install --cask libreoffice。没装时 UI 应提示，并从支持列表里去掉这些类型。

下一步