Ternilo.English
TERNILO / SELF-HOSTED-AI-CODING

开源 AI 编程助手:在本机开始使用 Ternilo

把 AI 助手放进真实项目:读文件、改代码、运行检查,成果留在你的工作目录里。个人本机使用不需要 Server、Worker 或登录账号。

安装并打开工作台

使用下方安装命令,或从 GitHub Releases 下载适合系统的客户端包。安装器校验 SHA-256,将完整发行包放进用户目录,再启动服务并打开浏览器。

运行现成发行包不需要 Rust 或 Node.js。文件搜索需要 ripgrep;Linux 的受限命令执行还需要 bubblewrap。安装器不会替你安装这些系统依赖。

让助手认识你的项目

  1. 在工作台选择项目文件夹,创建会话。
  2. 打开“设置 → 模型”,添加 Provider 的服务地址、协议与必要的 API Key,再添加真实 Model ID。
  3. 在会话输入框下方明确选择模型;先发送“列出项目的主要目录,说明从哪里开始阅读”。
  4. 确认读取结果后,再交代一项具体改动,并要求运行项目已有的检查。

本机使用和自主部署有什么区别?

本机的 ternilo serve 提供当前电脑上的工作入口。需要从手机访问、多台机器管理或多人共享时,再部署 Ternilo Server 并接入执行电脑;本地服务继续负责该机器上的文件和任务。

Ternilo Server 提供官方 Docker 镜像 ghcr.io/mosttt/ternilo-server,可使用官方 Compose 配置直接拉取并部署,无需本地构建。镜像版本、首次初始化、数据持久化和 HTTPS 配置请参考下方随最新发行版提供的 Docker Compose 部署文档。

关闭页面后,工作在哪里?

关闭网页不会停止仍在运行的本地服务。手动启动时应保持终端打开;Ctrl-C 或 ternilo stop 会停止服务。项目文件与 Ternilo 的会话数据分别保存,备份时需要分别保留。

模型请求会发送给所选 Provider。自主部署不等于模型推理一定在本机完成;需要本地推理时,应接入实际可用且协议兼容的本地模型服务。

一行安装

在执行任务的电脑上运行。安装器选择发行包、校验 SHA-256,并启动 serve --open-browser;旧版不支持该参数时由安装器打开浏览器。

Linux / macOS · Terminal
curl -fsSL https://www.ternilo.com/install.sh | sh
Windows · PowerShell
irm https://www.ternilo.com/install.ps1 | iex
手动下载发行包

常见问题

Ternilo 是开源的吗?

Ternilo 使用 Apache-2.0 许可证。源码、发行包及具体许可内容见项目仓库。

安装后就能免费使用模型吗?

需要配置自己的模型服务,或使用 Server 授予的模型访问。模型用量与费用取决于所选服务,Ternilo 不提供免费的模型额度承诺。

能直接在手机上安装这条命令吗?

这条命令用于执行任务的电脑。手机通过 Server 的网页入口或 PWA 访问已接入且在线的电脑。

继续阅读产品文档

getting-started.mddocker-compose.mddeployment.md

把这一步,放进你的项目。

查看产品功能演示,或安装 Ternilo 开始使用。

查看产品演示本地安装