セットアップウィザード

bun run setup は、ローカルでのBunベースのインストールに推奨されるセルフホストパスです。.env を作成し、CRYPTO_SECRET を生成し、Discordボットのトークンを尋ね、PostgreSQLを設定し、bun.lock に記録された正確な依存関係をインタラクティブにインストールするため、プロンプトに従うだけで済みます。再実行しても安全です。既存の .env の値は、再設定を選択しない限り保持されます。

パスの選択

コマンドを実行すると、2つのパスのいずれかを選択することになります。

bun run setup

パス	使用する場合	実行内容
フルインストール	軽量な追加機能を含む推奨のセットアップを行いたい場合。	基本インストールを実行後、以下の4つの追加機能を試行します。
基本インストール	最低限動作するボットのみが必要な場合。	`.env`、Discordトークン、PostgreSQL、および依存関係を作成・設定します。

用意しておくもの

GuildMembers、MessageContent、および GuildPresences の特権インテントが有効になっているDiscordボットのトークン。
データベース。 TomoriBotはすべてをPostgreSQLに保存します。ウィザードが自動で行うため、手動で設定する必要はありません。PostgreSQLがすでにインストールされている場合はそれを使用し、インストールされていない場合はDocker上で実行します。始める前に、どちらか一方がインストールされていることだけを確認してください。

psql が見つからない場合やプロビジョニングに失敗した場合、ウィザードは手動で実行するためのSQLを出力します。いずれにせよ、TomoriBotは初回起動時にスキーマ、シード、移行、pgcrypto、およびRAGスキーマを自動的に初期化します。

フルインストールの追加機能

フルインストールでは、まず基本インストールが実行され、その後以下の追加機能のインストールが試行されます。いずれかが失敗した場合、ウィザードは手動で完了させるためのコマンドやガイドを出力し、そのまま処理を続行します。

追加機能	目的
`pgvector`	ドキュメント/RAGメモリー用のベクトル検索。
`pg_cron`	オプションのスケジュールされたクールダウン/リマインダー行のクリーンアップ。
トークナイザーアセット	モデルを意識したロジットバイアス用のローカルのトークナイザーアセット。
URL Fetch MCP	バンドルされている `fetch_url` のフォールバック用のPython `mcp-server-fetch`。

これらを手動でインストールする場合は、オプションの追加機能（手動での「フルインストール」）を参照してください。

セットアップ後

bun run dev                          # ボットのみ
bun run launch --searxng --crawl4ai  # ボットとサイドカー（bun run launch --help を参照）

ボットがオンラインになったら、Discordで /config setup を実行してAIプロバイダーのキーを追加します。

更新

バックアップ優先のアップデーターコマンドである bun run update を使用してください。

これにより、bun run backup が実行され、続いて git pull --rebase --autostash、そして bun install --frozen-lockfile が実行されます。dist/ から実行する場合は --build を、Composeデプロイメントの場合は --docker を追加してください。詳細についてはメンテナンスとバックアップページを参照してください。