Hivekeep
JA
設定する
インストール

Hivekeepを動かす。

コマンド1つですべて完了。起動したらQueenieが会話で残りをセットアップするので、編集すべき設定ファイルはありません。

推奨 · いちばん簡単な方法

1行貼り付けるだけ。以上です。

LinuxまたはmacOSマシンのターミナルで実行してください。必要なものをすべてインストールします。

curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

完了したら、表示されたリンクをブラウザで開いてください。残りはQueenieにおまかせ。

オプション

カスタムポート、ドメイン、Dockerが必要ですか?

上のワンライナーで十分なら、ここは飛ばして構いません。必要なら、いくつかの質問に答えるだけで、あなたの環境にぴったりのコマンドを生成します。

1 · どう使いますか?

2 · 設定

3 · 実行

インストールshell
curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

暗号化キーは自動で面倒を見ます。インストーラーが自動生成して$DATA_DIR/.encryption-keyに保存するため、再起動してもシークレットは失われません。そのファイルはデータベースと一緒にバックアップしてください。(自分で管理したい場合は、上の上級者向けトグルで固定のENCRYPTION_KEYを設定できます。)

インストールが失敗したら
  • port already in use / EADDRINUSE: ポート3000が使用中です。上のポート欄を変更して、再実行してください。
  • Windows: インストーラーはLinuxとmacOS専用です。WSL2の中で実行するか、Docker Desktopをお使いください。
  • ダウンロードやクローンが進まない場合: マシンがHTTPSでgithub.comとbun.shに到達できることを確認してください(プロキシがブロックしている可能性があります)。

ブラウザでhttp://localhost:3000を開いてください。あとはQueenieが案内します(管理者アカウント、最初のAIプロバイダー、最初のエージェント)。編集すべき設定ファイルはありません。
高度な設定とその他の選択肢 前提条件と、Docker / ネイティブ / ソースの比較
はじめる前に

ワンライナーに必要なもの。

ほとんどのマシンにはすでにすべて揃っています。

sudoが使えること
不足しているシステムパッケージ(git、curl、unzip)のインストールに必要です。
約500 MBの空きディスク
クローンとビルドのための領域です。1 GB以上あれば余裕です。
64ビットのマシン
x86_64またはARM64。32ビット(古いRaspberry Pi)は非対応です。
外向きのHTTPS
github.comとbun.shからダウンロードするため、両方に到達できる必要があります。
opensslがあること
キーの生成に使います。ほぼすべてのLinuxとmacOSに同梱されています。

Windowsをお使いですか? ネイティブインストーラーはWindows上では直接動きません。WSL2(Linuxディストリビューションの中でワンライナーを実行)か、Docker Desktopをお使いください。

比較

ネイティブ、Docker、それともソースから?

3つとも動くアプリはまったく同じ。違いは、マシン上での住まい方です。

推奨

ネイティブ(install.sh)

とにかく動いてほしい方はこちら。自分のLinuxまたはmacOSマシンで、コマンド1つ。

  • コマンド1つでローカルにビルド、イメージの公開や取得は不要
  • 暗号化キーを自動で保存、シークレットが永続化される
  • サービスとして稼働(systemd / launchd)、ロールバックつき自動更新
  • エージェントがマシンを使いこなす: ツールや依存関係のインストール、ハードウェアへの直接アクセス
  • ホストシステムに変更を加える(設計どおりの挙動)
  • LinuxとmacOSのみ(WindowsはWSL2経由)
コンテナ

Docker

すでにDockerで暮らしていて、クリーンでサンドボックス化されたアプライアンスが欲しい方はこちら。

  • 完全に隔離され、ホストをまったく汚さない
  • Dockerが動く場所ならどこでも動く(Windowsを含む)
  • 公開イメージはまだ利用できないため、当面はネイティブを推奨
  • エージェントがインストールしたツールやバイナリは再起動で消える
  • データボリュームを永続化しないとシークレットを失う
ソースから

手動

コードを読みたい、いじりたい、自分のやり方で動かしたい方はこちら。

  • 完全なコントロール: 自分でクローンし、ビルドし、Bunで実行
  • コントリビューターと開発作業に最適
  • サービスも自動更新もなし、配線は自分で行う
  • Bun、ビルド、マイグレーション、暗号化キーをすべて手動で管理