IntentKit

IntentKit 是一个开源、可自托管的云智能体集群，可为您管理一支协作型 AI 智能体团队。

为什么选择 IntentKit

当前的 AI 智能体通常分为两大方向：

1. 本地优先（如 OpenClaw）：这类智能体主要作为个人助手或实验性工具使用。然而，它们往往需要昂贵的硬件支持，并且需要较高的本地权限。
2. 云原生：类似于现代 Web 应用，这些智能体运行在云端，几乎不占用本地资源，无需维护，且具有极高的可靠性，能够高效完成各类任务。

如果您正在寻找一款健壮的云原生解决方案，IntentKit 就是您的理想选择。

功能特性

• ☁️ 云原生：极致的资源效率。
• 🔒 设计安全：智能体从根本上无法访问您的任何密钥。
• 🤖 协作式 AI：多智能体协同工作，彼此调用与交互。
• 🔄 开箱即用：预配置完毕，即刻投入使用。
• 🔗 加密友好：可选的 Web3 和区块链集成。
• 🐦 社交媒体集成：无缝对接各大社交平台。
• 🛠️ 可扩展技能系统：轻松添加新功能。

文档

请在开始使用前查阅 文档。

部署

请阅读 部署指南，以顺利完成您的部署。

其他使用场景

除了自行部署 IntentKit 外，您还可以通过以下方式使用该项目：

• 作为 Python 库：导入并扩展 IntentKit，或将智能体集群能力集成到您现有的项目中。
• 通过 API：无论采用何种部署方式，您都可以通过内置的 API 端点从外部应用与智能体进行交互。

贡献

鉴于 AI 领域的发展速度极快，我们目前暂不接受通过 Pull Request 提交代码贡献。不过，欢迎您在 GitHub Issues 中提交功能需求和报告问题，这将是您参与项目开发的最佳方式。

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

IntentKit 快速上手指南

IntentKit 是一个开源的、可自托管的云原生智能体集群平台，旨在为您管理协作式 AI 团队。它无需昂贵的本地硬件，支持多智能体协作，并具备高度的安全性和可扩展性。

环境准备

在部署前，请确保您的环境满足以下要求：

• 操作系统：Linux (推荐 Ubuntu 20.04+), macOS, 或 Windows (需安装 WSL2)。
• 容器运行时：已安装 Docker 和 Docker Compose（推荐使用 Docker Compose V2）。
• 网络环境：能够访问 Docker Hub 及外部 API（如 LLM 提供商、社交媒体平台等）。
  • 国内用户提示：若拉取 Docker 镜像缓慢，建议配置国内 Docker 镜像加速器（如阿里云、腾讯云等）。
• API Keys：准备好您计划使用的 LLM 服务商（如 OpenAI, Anthropic 等）及第三方服务（如 Twitter/X, Web3 钱包）的密钥。

安装步骤

IntentKit 推荐使用 Docker 进行部署，以确保环境一致性和最小化维护成本。

1. 获取项目代码

克隆官方仓库到本地：

git clone https://github.com/crestal-network/intentkit.git
cd intentkit

2. 配置环境变量

复制示例配置文件并根据实际需求修改：

cp .env.example .env

编辑 .env 文件，填入您的 LLM_API_KEY 及其他必要的服务凭证。

3. 启动服务

使用 Docker Compose 启动所有组件：

docker compose up -d

等待容器启动完成后，可通过以下命令查看运行状态：

docker compose ps

注意：首次启动可能需要几分钟时间下载镜像并初始化数据库。

基本使用

部署完成后，您可以通过以下方式与 IntentKit 交互：

1. 访问管理界面

打开浏览器访问默认地址（具体端口请在 .env 或 docker-compose.yml 中确认，通常为）：

http://localhost:8000

在此界面中，您可以查看智能体状态、监控任务执行情况以及进行基础配置。

2. 通过 API 调用智能体

IntentKit 提供内置 API 端点，允许外部应用直接调用智能体集群。以下是一个简单的 curl 示例，用于发送意图请求：

curl -X POST http://localhost:8000/api/v1/intent \
  -H "Content-Type: application/json" \
  -d '{
    "content": "帮我分析今天的加密货币市场趋势",
    "agent_ids": ["analyst-agent-01"]
  }'

3. 作为 Python 库使用（可选）

如果您希望将 IntentKit 集成到现有的 Python 项目中，可以直接安装 PyPI 包：

pip install intentkit

然后在代码中导入并使用：

from intentkit import AgentCluster

cluster = AgentCluster(config_path="./config.yaml")
response = cluster.run("查询最新的区块链新闻")
print(response)

---

更多详细配置、高级技能扩展及生产环境部署方案，请参阅官方文档：https://intentcat.com/docs/