推荐
1. pip 安装（首选）
最快最简便的安装方式，内置首次运行向导，支持 Windows、macOS 和 Linux。
pip install ciris-agent然后运行： ciris-agent 启动首次运行向导
系统要求： Python 3.10+
其他安装方式
其他安装方式
2. Docker Compose
在隔离的容器环境中运行 CIRIS，适合需要可重现的本地或服务器部署场景。
docker compose up -d系统要求： Docker Engine 20.10+、docker compose 插件，以及包含 compose 文件的项目目录
3. GitHub 克隆（开发版）
克隆代码仓库，用于开发、自定义或参与贡献，可完整访问源代码。
git clone https://github.com/CIRISAI/CIRISAgent.git然后： 参照 README.md 进行手动安装配置
4. CIRISManager（企业版 / Canary 版）
通过 CIRISManager 实现受管理的灰度发布，支持逐步推出、自动化测试和回滚能力，适用于生产环境集群。
CIRISManager 提供自动化蓝绿部署与健康监控功能。如需部署配置，请联系团队。
最适合： 企业部署、生产集群、受管基础设施
你好，CIRIS
你好，CIRIS
获取第一个响应的最短路径。启动智能体后，从 Python 调用它。以下两段代码均可直接复制粘贴使用。
1. 启动智能体
运行 API 适配器，默认端口 8080。本地开发时 OBSERVER 权限无需认证。
pip install ciris-agent
ciris-agent --adapter api --port 80802. 从 Python 调用
异步 SDK。response.processing_time_ms 和 response.state 让您在每次调用时查看推理过程。
pip install ciris-sdk
# hello_ciris.py
import asyncio
from ciris_sdk import CIRISClient
async def main():
async with CIRISClient(
base_url="http://localhost:8080",
) as client:
response = await client.interact(
"Hello, CIRIS!"
)
print(response.response)
print(
f"[{response.state}] "
f"{response.processing_time_ms}ms"
)
asyncio.run(main())该 SDK 处于 预测试版阶段，接口可能在版本之间发生变化。完整 API 接口（15 个模块共 181 个端点）的文档见 GitHub 上的 ciris_sdk。
故障排查
故障排查
pip 安装失败
请确保 Python 版本为 3.10 或更高：
python --version尝试升级 pip：
pip install --upgrade pipDocker 容器无法启动
查看容器日志：
docker logs ciris-agent验证 Docker Compose 文件：
docker compose -f ~/ciris/docker-compose.yml ps