安装 CIRIS

ChatGPT 和 Gemini 的开源替代方案：推理过程可审计，支持 29 种语言，可接入 Home Assistant 实现完全开源的家居控制。

支持 iPhone、Android，以及 Windows、macOS 和 Linux 上的 pip / docker / git 安装方式。

📱 移动应用现已上线

您的私人 AI 智能体：私密、本地优先、开源

App Store Google Play

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

获取第一个响应的最短路径。启动智能体后，从 Python 调用它。以下两段代码均可直接复制粘贴使用。

1. 启动智能体

运行 API 适配器，默认端口 8080。本地开发时 OBSERVER 权限无需认证。

pip install ciris-agent
ciris-agent --adapter api --port 8080

2. 从 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 pip

Docker 容器无法启动

查看容器日志：

docker logs ciris-agent

验证 Docker Compose 文件：

docker compose -f ~/ciris/docker-compose.yml ps

需要帮助？