`arkor build` と `arkor start`

arkor build と arkor start は Studio の Run training ボタンのヘッドレス相当です。UI を起動せずにトレーナーを動かしたいとき（CI、サーバー、別スクリプトから）に使ってください。 Studio の Run training は内部的に arkor start（エントリー引数なし）をスポーンするので、両フローでランタイムパスは同一です。

`arkor build`

pnpm build

npm run build

yarn build

bun run build

src/arkor/index.ts を esbuild で .arkor/build/index.mjs にバンドルします。

概要

arkor build [entry]

引数

引数	デフォルト	説明
`entry`	`src/arkor/index.ts`	バンドルするソースエントリー。相対パスでも絶対パスでも動きます。

出力

.arkor/build/index.mjs（outDir のデフォルトは .arkor/build）。出力は単一の ESM ファイル、Node 22.6 をターゲットにし、packages: "external" で bare specifier（arkor、node_modules 内のもの）はバンドルせず、成果物はあなたの node_modules からランタイム SDK を解決します。インライン化されるのは相対 import のみです。エントリーが存在しない場合、arkor build は src/arkor/index.ts を作るか明示的なエントリーを渡すよう促すメッセージで例外が発生します。

`arkor start`

pnpm start

npm start

yarn start

bun start

.arkor/build/index.mjs を実行します。ランナーはバンドルを import し、登録済みトレーナーを見つけ（export const arkor を最優先、次に export const trainer、最後にデフォルトエクスポート）、trainer.start() の後に trainer.wait() を呼びます。

概要

arkor start [entry]

引数

引数	デフォルト	説明
`entry`	なし	渡されたとき、`arkor start` は実行前にこのエントリーでプロジェクトをリビルドします。省略時は既存ビルド成果物を再利用し、無ければデフォルトエントリーで自動ビルドしてから走ります。

無ければ自動ビルドする挙動は、Studio の “Run training” が 2 回 spawn を連鎖させずに済むためのものです。スクリプトからは通常、arkor build と arkor start を明示的に呼んで、ビルド失敗が走り出す前に表に出るようにしたいはずです。

振る舞いまとめ

状況	`arkor start` の挙動
`entry` 引数あり	与えられたエントリーでリビルドして実行。
成果物なし、`entry` なし	デフォルトエントリーで自動ビルドして実行。
成果物あり、`entry` なし	成果物を再利用してそのまま実行。

「成果物の再利用」のパスがあるおかげで、Studio はトレーナーの編集を train エンドポイントではなく /api/manifest のリビルド経由で表に出せます。CLI 中心のワークフローでは、src/arkor/ を編集したら毎回 arkor build を走らせてください。

よくあるエラー

arkor build:

メッセージ	意味	対処
`Build entry not found: <abs-path>. Create src/arkor/index.ts or pass an explicit entry argument.`（ビルドエントリーが見つかりません: `<abs-path>`。`src/arkor/index.ts` を作成するか、明示的なエントリー引数を渡してください）	デフォルトエントリーが存在せず明示的なエントリーも渡されなかった。	プロジェクトルート（`src/arkor/index.ts` を含むディレクトリー）から実行するか、エントリーを渡す。例: `arkor build path/to/entry.ts`。

arkor start:

メッセージ	意味	対処
`Build entry not found: <abs-path>. Create src/arkor/index.ts or pass an explicit entry argument.`（ビルドエントリーが見つかりません: `<abs-path>`。`src/arkor/index.ts` を作成するか、明示的なエントリー引数を渡してください）	`arkor start` はエントリー引数を渡したとき、または `.arkor/build/index.mjs` が無いとき先に `arkor build` を走らせます。不正なエントリーパスはランナー段階ではなくここで表に出ます。	存在するエントリーを渡すか、省略してデフォルトの `src/arkor/index.ts` に任せる。
`Training entry must export 'arkor' (from createArkor({...})) or 'trainer' (from createTrainer({...})), or default-export one of them.`（学習エントリーは `createArkor({...})` の `arkor` か `createTrainer({...})` の `trainer` をエクスポートするか、いずれかをデフォルトエクスポートする必要があります）	バンドルの import は成功したが、サポートしているエクスポート形をどれも露出していない。	受け付ける 3 つの形（名前付き `arkor`、名前付き `trainer`、デフォルト）はプロジェクト構成 § `src/arkor/` を参照。

runTrainer（プログラム）:

メッセージ	意味	対処
`Training entry not found: <abs-path>. Provide a path or create src/arkor/index.ts.`（学習エントリーが見つかりません: `<abs-path>`。パスを指定するか `src/arkor/index.ts` を作成してください）	ランナーを直接呼んだとき（例: `import { runTrainer } from "arkor"`）に存在しないパスを渡した場合に表に出ます。CLI はこのパスに当たりません。`arkor start` ならビルド段階で先に失敗します。	存在するパスを渡すか、`import "./src/arkor/index.ts"` を先にしてモジュールロード時に検知。

例

ビルドして開始（2 ステップ）:

pnpm build
pnpm start

npm run build
npm start

yarn build
yarn start

bun run build
bun start

別エントリーでリビルドを強制（1 ステップ）:

pnpm start src/arkor/experiment.ts

npm start -- src/arkor/experiment.ts

yarn start src/arkor/experiment.ts

bun start src/arkor/experiment.ts

トレーナー編集後、古い成果物をリビルド:

# src/arkor/trainer.ts を編集した後:
pnpm build && pnpm start

# src/arkor/trainer.ts を編集した後:
npm run build && npm start

# src/arkor/trainer.ts を編集した後:
yarn build && yarn start

# src/arkor/trainer.ts を編集した後:
bun run build && bun start

はじめに

ロードマップ

コンセプト

CLI

SDK

Studio

Cookbook

arkor build / start

`arkor build` と `arkor start`

`arkor build`

概要

引数

出力

`arkor start`

概要

引数

振る舞いまとめ

よくあるエラー

例

​arkor build と arkor start

​arkor build

​概要

​引数

​出力

​arkor start

​概要

​引数

​振る舞いまとめ

​よくあるエラー

​例

`arkor build` と `arkor start`

`arkor build`

概要

引数

出力

`arkor start`

概要

引数

振る舞いまとめ

よくあるエラー

例