インストール

01必要なもの

• Spinel 2026.10.27.7020（Cybertrain::SPINEL_TAG。.github/workflows/ci.yml の SPINEL_TAG と同じリリース）。saeki-mototsune/spinel（Cybertrain::SPINEL_REPOSITORY）のリリースで、CyberTrain が必要とする修正を本家のリリースより先に取り込んだ matz/spinel のフォークです。他のバージョンでは未テストです。手動でインストールする必要はありません：cybertrain コマンドが、初めて必要になったときにそのリリースを ~/.cybertrain にビルドします（cybertrain setup は求めに応じてそれを行います）。ただし、そのリリースの spinel がすでに PATH 上にある場合は除きます — Spinel のインストールの仕組みを参照してください。
• そのビルドには：C ツールチェーン（cc、または CC で指定したコンパイラ）と make — Spinel はすべてのプログラムを C にコンパイルします — さらに git と curl。
• SQLite 3 のヘッダーとライブラリ（Debian/Ubuntu では libsqlite3-dev。macOS では Xcode のコマンドラインツールに含まれています） — モデルは gem ではなく、Spinel の FFI を直接使います。
• zlib のヘッダーとライブラリ（Debian/Ubuntu では zlib1g-dev。macOS では SDK に含まれています） — gzip されたリクエストボディ（request.decoded_body）は、同じ方法でバインドしたシステムの zlib で展開されます。
• Ruby 3.2+ と RubyGems。cybertrain コマンドのためだけに必要です（アプリケーションが CRuby 上で動くことはありません）。Ruby 3.2 では、Spinel のビルドに prism gem も必要です（下記）。

cybertrain doctor はこれらのツールとヘッダー、Spinel のインストールを確認します。必要なものが欠けている場合は、プラットフォームに応じたインストールコマンドも表示します。

02CLI をインストールする

gem install cybertrain
cybertrain doctor

1 行目で RubyGems からコマンドをインストールし、2 行目で必要なものを確認します。そこから先は、cybertrain new から cybertrain build まで、チュートリアルが続けます。

03cybertrain コマンド

cybertrain help はこれらのコマンドを表示します：

• cybertrain new NAME [--path DIR | --version V | --git URL [--ref R]] [--skip-spin] は NAME にアプリケーションを作成し、その中で spin lock と spin run gen を実行します。必要なら先に Spinel をインストールします。
• cybertrain generate scaffold NAME field:type ...（エイリアスは g scaffold）は、カレントディレクトリのアプリケーションにリソースを追加します。
• cybertrain generate authentication は、そのアプリケーションにメールアドレスとパスワードによるサインインを追加します：users と sessions のテーブル、User と Session のモデル、サインインとサインアップのコントローラーとビュー、ルート、ApplicationController の before_action、そしてテストです（サインインを追加するを参照）。--invite-only を付けるとサインアップのページはありません：ユーザーは ./NAME user EMAIL で作成し、ユーザーがまだいない間は、最初のユーザーを /setup ページでも作成できます。このページはサーバー自身のマシンにだけ応答し、起動時の警告が表示するワンタイムトークンを必要とします。
• cybertrain generate attachment MODEL FIELD [--any] は、スキャフォールド済みのモデルにファイルアップロードを追加します：5 つのメタデータカラム、モデルのメソッドとコールバック、ダウンロードのアクション、ルート、フォームのフィールド、そしてテストです（カバー画像を追加するを参照）。スキャフォールドのフィールド cover:attachment も同じことを行います。
• cybertrain db migrate は生成を行い、未適用のマイグレーションを適用して、もう一度生成します（spin run gen; spin run db -- migrate; spin run gen）。cybertrain migration もエイリアスとして残されています。
• cybertrain db COMMAND... は spin run gen の後に、その他のデータベースコマンドを実行します：status、rollback [N]（実行後にもう一度生成します）、schema:dump、create。
• cybertrain server [PORT] は生成を行ってから開発サーバーを起動します（spin run gen; spin run NAME、または spin run NAME -- PORT。デフォルトのポートは 3000）。
• cybertrain build は app/views/ を埋め込んで NAME をビルドし、dist/（バイナリ、public/、storage/、tmp/）を組み立てます。
• cybertrain spin ARGS... は、固定された Spinel で spin を任意のディレクトリから実行します（cybertrain spin test、cybertrain spin run gen -- --check）。
• cybertrain setup [--force] は Spinel 2026.10.27.7020 を ~/.cybertrain にインストールします（そのリリースの spinel がすでに PATH 上にある場合を除く）。--force は ~/.cybertrain 以下のコピーを再ビルドします。
• cybertrain doctor は C ツールチェーン、SQLite のヘッダー、Spinel のインストールを確認します。
• cybertrain version はバージョンを表示します。

db、server、build はアプリケーションの中で実行します。NAME はそのアプリケーションの spin.toml にある [package] name です。

04Spinel のインストールの仕組み

spin を実行するすべてのコマンド（new、db、server、build、spin）は、まず Cybertrain::SPINEL_TAG のリリースの Spinel が使えることを確かめます。PATH 上の spinel（spin を伴うもの）の spinel --version がそのリリースを報告すれば、それをそのまま使います。そうでなければ、cybertrain が ~/.cybertrain/spinel/2026.10.27.7020/ 以下に置いているコピーを使います。それもなければ、cybertrain が Cybertrain::SPINEL_REPOSITORY のリリースタグからそのコピーをビルドします（git clone、make deps、make -j、make install PREFIX=...）。ビルドは一度だけで、数分かかります。ビルドのログは ~/.cybertrain/log/spinel-2026.10.27.7020-build.log です（手順が失敗すると、その最後の数行が表示されます）。

ビルドに必要なツールが欠けている場合、cybertrain はビルドを始める前に、どれが足りないかを伝え、プラットフォームに応じたインストールコマンドを表示します。PATH 上にある別リリースの spinel が使われたり変更されたりすることはありません：cybertrain は自前のコピーを持ちます（そしてインストールするときにそう伝えます）。

cybertrain setup は同じことを求めに応じて行います。さらに、自前のコピーが使われている場合は、spin を自分で実行するために、それを PATH に加える行を表示します：

export PATH="$HOME/.cybertrain/bin:$PATH"

~/.cybertrain/bin には使用中のリリースを指す spinel と spin のリンクがあるので、リリースが上がってもこの行はそのまま使えます。cybertrain spin ... には PATH はまったく必要ありません。