解决什么问题

ChatCoolify 不替代 Coolify，而是把官方 REST API 变成可测试的 Python 客户端和 CLI：

• 默认只读，适合 AI 清点服务器、项目、应用与部署状态；
• 写操作必须有 Coolify Token 权限并显式传递 --allow-write；
• 支持 ChatEnv 配置、公开 Git 网站计划与创建、部署触发；
• 文档覆盖邀请制协作、MCP、网站、API、数据库和运维边界。

安装

python -m pip install --upgrade ChatCoolify
coolify --version
coolify --tree

支持 Python >=3.10。发布包仍叫 ChatCoolify，Python import 仍是 chatcoolify；安装后的唯一 CLI 是 coolify，不提供 chatcoolify 命令别名。

最快开始

已有平台账号可通过 coolify platform 完成本地目录上传、原生预览、显式发布及回退；平台按项目授权，普通用户不持有原生 Team token。见本地项目平台。以下保留原生 Coolify 客户端用法，其写操作仍需 --allow-write。

coolify --base-url https://<coolify-url> health

需要受保护 API 时，先在 Coolify 创建 Team-scoped 最小权限 Token，再通过 ChatEnv 配置：

chatenv init -t coolify -I
chatenv set COOLIFY_BASE_URL=https://<coolify-url>
chatenv set COOLIFY_API_TOKEN='<team-scoped-token>'
coolify overview

网站计划示例

coolify website-plan \
  --project-uuid PROJECT_UUID \
  --server-uuid SERVER_UUID \
  --environment-uuid ENVIRONMENT_UUID \
  --repository-url https://github.com/example/simple-site

省略 --domain 时，计划会请求 Coolify 从已配置的泛域名池自动分配唯一 tenant URL；需要自定义域名时才显式传入 --domain。查看完整的 真实 Git 到 HTTPS 演示。

该命令只输出官方 API payload。真正创建资源需要同时具备 write Token 和显式写门：

coolify --allow-write website-create ...

安全边界

• 不把 Token 写入参数、仓库、日志或提示词。
• 不向普通 AI 或 CI 提供 root Token。
• Team 角色不是虚拟机隔离；不可信代码不应共享生产 Docker 守护进程。
• 完整操作流程见 文档。

开发

python -m pip install -e '.[dev,docs]'
python -m pytest -q
python -m mkdocs build --strict
python -m build
python -m twine check dist/*

许可证

MIT。