Josh-XT/AGiXT · 上手攻略

  • 仓库：Josh-XT/AGiXT
  • 链接：https://github.com/Josh-XT/AGiXT
  • 分类：agent / llm-infra
  • 作者：spark
  • 更新：2026-07-17

这是什么

AGiXT（AGI eXecution & Tasks）是一个 动态 AI Agent 自动化平台，定位是「多 AI provider 之上的中央神经系统」。它解决的核心问题是：让一套自然语言指令，能在 OpenAI / Anthropic / Google / Azure / 本地模型之间无缝切换，并自动编排复杂任务、执行扩展动作。

核心卖点：

  • 40+ 内置 extension：从 Tesla 车辆控制、企业资产管理、加密货币交易、智能家居，到通用 HTTP / 数据库 / 邮件 / 文件系统；
  • 多 provider 支持：OpenAI、Anthropic、Google、Azure、本地模型都接，同一份指令可跨 provider 切换；
  • 企业级特性：OAuth、多租户、高级安全与合规、审计日志；
  • 自适应记忆 + 智能上下文：跨会话保留用户偏好、任务历史；
  • 可扩展插件系统：自定义 extension 接入现有服务；
  • 实时集成：WebSockets、webhooks、实时数据流。

仓库 3.2k+ Stars，最近提交 2026-06-17，主语言 Python，许可证 MIT。文档已迁到独立的 docs.agixt.com（README 标注），平台官网 agixt.com。

解决什么问题

把多个 AI provider + 多个外部服务粘成一个能跑长任务的 Agent，普遍会撞三堵墙：

  1. Provider 切换成本高：今天用 OpenAI，明天想换 Claude / 本地 Llama，业务代码要重写一遍。
  2. 服务接入碎片化：写一个 Agent 就要写一份「发邮件 / 调 API / 查 DB / 控制 IoT」的胶水，每个项目重写。
  3. 企业落地难：个人项目 demo 跑得通，但一旦涉及多用户、OAuth、审计、合规，全要自己糊。

AGiXT 的解法：

  • Provider 抽象层：你写的指令是「provider-agnostic」的，切换 provider 改配置不改代码；
  • Extension 体系：把外部能力（HTTP / DB / IoT / Email / SSH / …）做成统一 interface 的 plugin，40+ 内置开箱即用；
  • Web + API + SDK 三入口：有 Web 控制台、有 REST API、有 Python SDK 和 TypeScript SDK，可以嵌入现有系统；
  • 企业特性：OAuth、多租户、审计直接内置。

一句话定位：AGiXT = 一个可以马上拉到生产环境的「多 provider + 多服务」Agent 编排底盘，而不仅仅是一个框架。

快速安装

最简路径：pip install agixt + agixt start。

# 1) Python 包
pip install agixt

# 2) 启动（默认起 Web + API）
agixt start

启动后默认会在 http://localhost:7437 提供：

  • Web UI（控制台、对话、Extension 管理、Provider 配置）；
  • REST API（供其他系统调用）；
  • WebSocket（实时流式响应）。

详细配置（Provider / Extension / 用户）

AGiXT 的所有 provider key、扩展配置、用户都走 Web UI 首次启动向导 或 agixt.yaml 配置文件。README 把详细说明全部指向了 docs.agixt.com，包括：

  • Getting Started Guide
  • Core Concepts
  • Provider Configuration（OpenAI / Anthropic / Google / Azure / Ollama / …）
  • Authentication Setup（OAuth、JWT）
  • API Reference
  • Extension Development（自己写 plugin）

SDK

# Python SDK
pip install agixtsdk

# TypeScript SDK
npm install agixt

仓库：

  • Python: https://github.com/AGiXT/python-sdk
  • TypeScript: https://github.com/AGiXT/typescript-sdk

核心用法

CLI 启动 + Web 控制台

agixt start
# 打开 http://localhost:7437
# 1) 选 AI provider（OpenAI / Anthropic / Google / Azure / Ollama / …）
# 2) 填 API key
# 3) 启用需要的 extension（HTTP / Email / DB / SSH / Tesla / …）
# 4) 开始对话或创建 Agent chain

Python SDK（典型 pattern）

from agixtsdk import AGiXTSDK

agi = AGiXTSDK(base_uri="http://localhost:7437", api_key="your-api-key")

# 列 provider
print(agi.get_providers())

# 列可用 extension
print(agi.get_extensions())

# 发指令
resp = agi.chat(
    agent_name="my-agent",
    prompt="帮我查一下今天 GitHub 上 OpenAI 仓库的 star 数，并发邮件给我",
)
print(resp)

上面 SDK 方法名按 agixtsdk 包公开 API 给出（get_providers / get_extensions / chat 等），具体参数名、字段以 help(AGiXTSDK) 或 https://github.com/AGiXT/python-sdk 为准——SDK 在 1.x 阶段有微调。

TypeScript SDK

import { AGiXTSDK } from "agixt";

const agi = new AGiXTSDK({
  baseUri: "http://localhost:7437",
  apiKey: process.env.AGIXT_API_KEY,
});

const resp = await agi.chat({
  agentName: "my-agent",
  prompt: "查一下今天的天气，并把结果写进 Notion",
});
console.log(resp);

Extension（插件）工作原理

每个 extension 是一个 Python 模块，实现统一的 AGiXT 接口（提供 commands 列表和 execute(command, args) 方法）。比如「HTTP」extension 提供 http_get / http_post / http_put / http_delete 命令；「Email」extension 提供 send_email / read_inbox。Agent 在生成 prompt 时会自动知道哪些 extension 可用、它们的命令签名。

自定义一个 extension 大致流程：

  1. 继承 AGiXT 基类，实现 commands 和 execute()；
  2. 放进 extensions/ 目录（或通过 Web UI 装载）；
  3. 重启 agixt start 或热加载；
  4. 在对话里直接用自然语言调用（Agent 会自己路由）。

详细模板见 docs.agixt.com 的 Extension Development 章节。

Adaptive Memory（自适应记忆）

AGiXT 内置三层记忆：

  • 短期：当前会话上下文；
  • 长期：跨会话的用户偏好、关键事实；
  • 任务级：单个任务链的执行历史。

打开 Web UI → Agent 编辑页 → Memory Settings，可以查看 / 注入 / 清理；也可以在 SDK 里调 agi.add_memory() / agi.get_memories()（具体方法名以 SDK 文档为准）。

典型适用场景

  • 企业内部 AI 中台：HR、销售、客服、运维各自有专属 Agent，统一挂在 AGiXT 上，权限 / 审计 / 计费集中管。
  • 多 provider 灾备 / 成本优化：平时用便宜的本地模型跑长任务，关键决策切到 Claude / GPT，按成本动态路由。
  • 智能家居 / IoT 控制：Tesla / Home Assistant / Philips Hue 之类 extension 直接开箱即用，自然语言控制物理设备。
  • 个人数字助理：把 40+ extension 当作「技能树」，按需启用。
  • SaaS 嵌入：把 AGiXT 作为后端引擎，外面套自己的 UI / 收费 / 客户体系。

坑与注意

  1. 许可证双标：GitHub 仓库 LICENSE 是 MIT，但 README / 平台官网在历史上提过「商业版」（企业版 SaaS）。开发用代码本身 MIT 可商用没问题，但若要直接订阅他们的托管平台，要看清条款。
  2. 文档不在 GitHub：README 现在只放「指针」，所有教程 / API 参考 / 配置示例都在 docs.agixt.com，网络环境能否访问 docs 站点要提前验证（GitHub 抓不到完整文档）。
  3. Web 控制台是主要配置入口：大量设置（provider key / OAuth / extension 启用）走 UI 而非配置文件；纯 CLI / 纯代码风格的用户会觉得别扭。
  4. Token 燃烧器：默认 Agent 会按 prompt 长度 / 步骤数累积上下文，长任务跑下来很容易把窗口塞满；要么用任务级 chain 分段，要么打开 memory 压缩。
  5. Extension 自定义的版本兼容：AGiXT 1.x → 2.x 重写过插件接口，老 extension 升级前要核对 API。
  6. 认证方式：默认是 API key；企业部署需要切到 OAuth / JWT，按 docs.agixt.com 的 Authentication Setup 章节配。
  7. Pump.fun 链接：README 里有 pump.fun 链接，是项目方发行的 meme coin——跟代码本身无关，别误把它当成项目方联系方式。

与同类对比

工具 形态 关键差异
AGiXT 多 provider 平台 + 40+ extension 上手即用，Extension 体系完整，企业特性内置
LangChain LLM 编排框架 灵活但要自己写 extension；Provider 切换要改代码
AutoGen (Microsoft) 多 Agent 协作框架 学术味更重，extension 生态薄
CrewAI 角色化多 Agent 框架 适合「团队模拟」，extension 没有 AGiXT 多
n8n / Flowise 低代码工作流 偏可视化拖拽；extension 是节点不是 plugin
OpenInterpreter 本地代码执行 Agent 偏本地 shell / Python，扩展靠 SDK
OpenHands (OpenDevin) 软件工程 Agent 强在「写代码」任务；不像 AGiXT 那样横向铺

一句话：AGiXT 是「多 provider × 多服务 × 企业特性」三轴同时开箱的现成平台，定位比 LangChain 更成品、比 n8n 更 AI-native。

一句话推荐结论

如果你想立刻搭一个能调 40 种外部服务、跨多个 AI provider、支持多用户和审计的 Agent 平台，而不是从零写编排代码——pip install agixt && agixt start 是当前最快的路径；纯开发者想要「灵活编排」的话，还是 LangChain / LlamaIndex 更合适。

参考来源

  • GitHub README: https://github.com/Josh-XT/AGiXT
  • 官方文档: https://docs.agixt.com
  • 平台官网: https://agixt.com
  • Python SDK: https://github.com/AGiXT/python-sdk, https://pypi.org/project/agixtsdk/
  • TypeScript SDK: https://github.com/AGiXT/typescript-sdk, https://www.npmjs.com/package/agixt
  • 社区: https://discord.gg/d3TkHRZcjD

不确定处

  • Python SDK 的具体方法名（get_providers / get_extensions / chat 等）按公开仓库常见命名给出，参数名以 help(AGiXTSDK) 或 SDK 仓库 README 为准。
  • 「商业版 / 企业版 SaaS」是 README / 官网历史上提到过的提法，当前是否仍提供独立商业版需要直接咨询项目方确认——代码本体是 MIT。
  • 启动端口默认 7437 是 README 与公开博客多次出现的值，若端口被占用，启动日志会提示实际监听端口。
  • agixt.yaml 的字段结构在 docs.agixt.com 维护，本攻略抓不到该站点的完整目录时，按 Web UI 首次启动向导生成的最稳。