Bitterbot-AI/bitterbot-desktop

Bitterbot – ローカルファーストの個人用AI

何であるか – Bitterbotは、自宅のコンピュータ上で自己完結型のAI「エージェント」を実行するオープンソースのデスクトップアプリケーションです。一般的なチャットボットがユーザーのプロンプトをリモートのLLMに転送するのとは異なり、Bitterbotは持続的で生物学的にインスパイアされた記憶を保持し、ツール（ウェブブラウジング、コード実行、WhatsAppメッセージ送信）を実行でき、定期的に「夢」を観て学習内容を統合します。また、小さなピアツーピア（P2P）マーケットプレイスも備えており、エージェントは検証済みスキルをUSDCで販売できますが、金銭的要素はオプションです。

主要なコンセプト

• 生物学的スタイルの記憶 – 知識は知識クリスタルとして保存され、強化されない限り劣化します。これはエビングハウスの忘却曲線を模倣しています。ホルモンシステム（ドーパミン、コルチゾール、オキシトシン）が各ターンごとにエージェントのトーンと集中力を調整します。
• ドリームエンジン – 数時間ごとにエージェントはオフラインになり、「夢」モード（リプレイ、変異、圧縮、リサーチなど）を実行し、記憶を再編成し、再利用可能なスキルを生成し、ドリーム品質スコアで結果を評価します。
• 継続的リコール – クエリがトークンウィンドウを超える場合、Bitterbotは1000万トークンの履歴を検索するサンドボックス化されたサブLLMを起動し、結果をキャッシュします。
• 実行可能なスキルとインターセプター – スキルはMarkdownで定義されますが、決定論的なコードインターセプターで保護され、エージェントのホルモン状態を確認し、ツール呼び出しを変更、承認、またはブロックできます。
• P2Pスキルマーケットプレイス – エージェントは検証済みスキル（Ed25519署名付き）を公開し、BaseテストネットでUSDCを獲得できます。ウォレットはデフォルトで無効になっています。

始める方法

1. Node ≥ 22 をインストール（リポジトリにはCorepackが同梱されています）。pnpm を有効化します：

   corepack enable pnpm || npm install -g pnpm
   

2. リポジトリをクローンし、提供されたスクリプトでシステム依存関係（ffmpeg、ripgrep、jqなど）をインストールします：

   git clone https://github.com/Bitterbot-AI/bitterbot-desktop.git && cd bitterbot-desktop
   bash scripts/setup-deps.sh
   pnpm install
   pnpm exec playwright install --with-deps chromium
   

3. オンボーディングウィザードを実行し、APIキー（Anthropic、OpenAI、Tavily、Braveなど）の入力、メモリ埋め込み設定、チャネル構成、およびオプションのウォレット作成を完了します：

   pnpm bitterbot onboard
   

4. ウィザードが終了すると、ゲートウェイとコントロールUIが自動的に起動します。ブラウザで http://127.0.0.1:19001 を開き、チャット、ドリームの表示、スキルの管理、エージェントの監視を行います。
5. 開発用にはウォッチモードが利用可能です：

   pnpm dev:all          # ゲートウェイ + Vite UI のホットリロード
   # または2つのターミナルに分ける
   pnpm gateway:watch
   cd desktop && pnpm dev
   

主要コンポーネント

サービス	URL	役割
ゲートウェイ	ws://127.0.0.1:19001	UI、CLI、外部クライアントが使用するWebSocket API
コントロールUI	http://127.0.0.1:19001	ブラウザベースのダッシュボード。チャット、ドリーム、スキルライブラリ、診断情報を表示
オーケストレーター（P2Pサイドカー）	ゲートウェイによって自動起動	分散型スキル交換とウォレット操作を処理

一般的な利用例

• 個人用知識アシスタント – プロジェクトの詳細や過去の会話、好みを再プロンプトせずに記憶します。
• ツール拡張型自動化 – ウェブをブラウズしたり、シェルコマンドを実行したり、WhatsAppメッセージを送信したりできます。
• リサーチアシスタント – ドリームエンジンのリサーチモードは、情報の自動取得と再利用可能なスキルとしての保存を自律的に行います。
• 実験プラットフォーム – 開発者は新しい記憶アーキテクチャ、ホルモンモデル、またはスキルインターセプターをプロトタイピングし、ローカルで実行できます。

制限事項と現在の状態

• 金銭的機能（USDCウォレット、P2Pスキル取引）はオプションで実験的です。テストネット上で動作し、明示的な設定が必要です。
• 記憶の統合とドリームサイクルはCPU集約的です。ドキュメントでは最新のデスクトップを推奨し、マシンがアイドル時のみドリームエンジンを実行することを提案しています。
• システムは、主に推論のために外部LLM API（Anthropic、OpenAIなど）に依存しています。ディープリコール用のサブLLMのみがローカルでサンドボックス化されています。
• Windows対応はWSL2に限定されています。ネイティブWindows実行は公式にテストされていません。
• 最新リリース（2026.2.15）時点でプロジェクトはまだ開発中であり、一部のドキュメント（例：LIMITATIONS.md）では特定の機能が変更される可能性があると警告しています。

さらに学ぶには

• ドキュメント – docs/ には記憶アーキテクチャ、ディープリコール、インターセプター、ドリームエンジンに関する詳細なセクションが含まれます。
• ライブ例 – READMEには、エージェントが自己生成した作業記憶を示す実際の MEMORY.md スナップショットが含まれています。
• コミュニティ – 更新情報や議論のため、X（@Bitterbot_AI）でプロジェクトをフォローしてください。

---

上記のすべての情報はリポジトリのREADMEから直接取得したものであり、追加機能は推測されていません。