rill

环境要求

• macOS 或 Linux 类 Unix 环境（README 的安装方式是 curl 管道脚本）
• 已安装 curl 命令
• 需要能访问互联网以拉取安装脚本与依赖
• 本地可用的 DuckDB 或 ClickHouse 作为 OLAP 引擎（初始化时二选一）
• 磁盘上有一个用于存放项目的可写目录（如 ~/my-rill-project）

安装与启动步骤

1. 1安装 rill

   README 提供的官方安装方式是执行 rill.sh 安装脚本，脚本会下载并安装 rill 命令行工具。注意这是一条管道命令，执行前请确认来源可信。

   curl https://rill.sh | sh

   复制

2. 2创建并启动项目

   用 rill start 指定项目名，会创建项目并打开 UI。README 示例项目名为 my-project，可直接替换成你自己的名称。

   rill start my-project

   复制

3. 3交互式脚手架（可选）

   README 推荐用 rill init 交互式创建项目，会依次询问项目名、OLAP 引擎、AI 代理说明，并生成配置文件。

   rill init

   复制

4. 4启动已有项目

   若已经用 rill init 在 ~/my-rill-project 生成过项目，可直接用 start 启动它，README 给出的启动命令就是这一步。

   rill start my-rill-project

   复制

关键配置

如何确认成功

执行 rill start 后 UI 会自动打开，浏览器能看到项目界面即启动成功；若未自动打开可查看终端输出的访问地址。

常见问题

注意事项

• README 未给出 uninstall、升级、Docker 部署等说明，本文档未涉及这些操作。
• 安装脚本通过管道直接执行，请自行确认脚本来源可信后再运行。
• rill init 的提问项与输出文案与 README 示例一致，实际交互可能因版本略有差异。
• 需要更多细节可查看官方文档 https://docs.rilldata.com/ 与官网 https://www.rilldata.com。