クイックスタート
ゲートウェイ、loggerd、admin を、自分のマシン上で 1 つのプロセスとして実行します。公開されるポートは 127.0.0.1 だけにバインドします。
インストールせずに試す
運用者が管理する公開スタンド(OpenAI 互換のエンドポイントと管理コンソール)が https://yabanin.ai にあります。任意のクライアントを https://yabanin.ai/gw/v1 に向け、スタンドキーを使います。ローカルの Docker は不要です。資格情報は運用者に依頼します。スタンドは同じクイックスタートのスタックを実行するため、このガイドの残りはそのまま当てはまります。スタンドが何であるか、どのように再導入されるかは、公開スタンド を参照します。
要件
- Compose v2 付きの Docker
make、openssl、curl- イメージのビルドとコンテナ用に、約 4 GB の RAM
5 つのコマンド
リポジトリのルートから実行します。
bash scripts/quickstart/init-env.sh
make quickstart-up
make quickstart-seed
make quickstart-smoke KEY=yb_... # the key seed printed once
make quickstart-down
init-env.sh は、3 つのランダムなキーを含む deploy/quickstart/.env を書き、モードを 600 に設定します。そのファイルがすでに存在する場合、スクリプトはファイルを変更しません。make quickstart-up は同じスクリプトを実行し、イメージをビルドし、Postgres、Redis、マイグレーション、オールインワンの yabanin dev プロセス、任意のモックプロバイダ(Compose プロファイル mock)を起動します。
make quickstart-seed は、正規の yabanin seed ワンショットサービスを実行します。組織、デフォルトのチーム、予算、モデル、開始クレジット、API キー、ルート管理者を 1 ステップで作成し、その後 API キーを 1 回、管理者パスワードを 1 回表示します。両方を保管します。このコマンドはそれらをファイルへ書きません。再実行は安全な no-op です。シードキーは再利用され、平文は再度表示されません。
管理
http://127.0.0.1:8086 を開き、QS_ADMIN_EMAIL(変更していなければ admin@localhost)と、シードで表示されたパスワードでサインインします。
実モデル
シードの前に deploy/quickstart/.env を編集します。
QS_MODEL— レジストリ名QS_UPSTREAM_URL—yabaninコンテナから到達できる、OpenAI 互換のベース URL
シードは、モデルを openai-compat プロバイダで登録します。これには OpenAI 互換サーバーが直接含まれ、llama.cpp の /v1/chat/completions エンドポイントも含まれます。プロバイダ固有のアダプタ(llamacpp、vllm、...)の場合は、シード後に管理コンソール(モデルページ)でモデルを登録します。
ローカルの llama.cpp サーバーの場合は、メインの compose ファイルからプロファイルを起動します。
docker compose -f deploy/docker-compose.yml --profile llamacpp up -d
QS_UPSTREAM_URL をそのサーバーに向けます。
あるいは、.env の編集を省略し、シード後に管理コンソールで組織ごとのプロバイダキーを追加します。BYOK(設定 → プロバイダキー)を参照します。
モックプ ロバイダを省略するには、--profile mock なしで Compose を実行し、シードの前に上流 URL を設定します。make quickstart-up はこのプロファイルを含むため、スモークのチャット呼び出しに送り先があります。
停止
make quickstart-down はスタックを停止し、データベースのボリュームは残します。クリーンなデータベースが必要なときは、自分で down -v を足します。
制限
- この compose ファイル内の Postgres のユーザーとパスワードは、固定の開発用の値です(
yabanin)。 - 生成されたセッション用、HMAC 用、暗号化用のキーは、このローカルファイル専用です。
0.0.0.0で待ち受けるものはありません。- このスタックは本番の導入ではありません。