Repolode
ShenSeanChen

ShenSeanChen/waku-agent

読みやすいPythonで書かれたローカルファーストの個人向けAIアシスタント。独自のエージェントループ、SQLiteベースのメモリ、組み込みの評価機能を備えています。

代替できる製品:ChatGPT

スター
2,082
フォーク
410
未解決の Issue
57
最終コミット
11 日前

これは何?

waku-agentは、自分のマシン上で動作する個人向けAIアシスタントです。4つの要素を中心に構成されています。ターミナル、ブラウザダッシュボード、Telegram、Discordなどのゲートウェイを1つのエージェントループにつなぐハーネス、推論・行動・反復を行う約95行のPythonループ、意味記憶・エピソード記憶・手続き記憶(スキル)の各種メモリを扱うシステム、そして決定論的テストとLLM-as-judgeによるスコアリングを組み合わせた評価レイヤーです。

メモリは単一のSQLiteファイルに保存されます。各メッセージを記憶する価値があるかどうかはゲートが判断し、統合処理によって保持する内容を決定します。Anthropic、OpenAI、Gemini、DeepSeek、OpenRouterなど複数のモデルプロバイダーに対応しており、環境変数とAPIキーで選択できます。オプションの連携機能を使うと、エージェントをホスト型のWaku Memoryサービスに接続し、同じメモリをほかのエージェントと共有できます。

このプロジェクトは、ブラックボックスとして使うのではなく、コードを読んで変更することを意図しています。ライセンスはMITですが、hosted/ディレクトリはElastic License 2.0を採用しています。

主な機能

  • 01推論・行動・反復を行う、素のPythonで書かれた約95行のエージェントループ
  • 02意味記憶・エピソード記憶・手続き記憶をローカルのSQLiteファイルに保存
  • 03ターミナル、ブラウザダッシュボード、Telegram、Discord、音声の各ゲートウェイ
  • 04リリースゲートを備えた、決定論的テストとLLM-as-judgeによる評価
  • 05Anthropic、OpenAI、Gemini、OpenRouterなど複数のモデルプロバイダーに対応

ユースケース

  • メモリをローカルに保持する個人向けアシスタントをノートPCで動かす
  • 小規模なコードベースで、エージェントループ、メモリ検索、評価がどう連携するかを学ぶ
  • ハーネスをforkして、新しいメッセージングゲートウェイやツールを追加する
  • Waku Memoryを介して、Claude Code、Codexなどのエージェント間でメモリを共有する

トピック

よくある質問

waku-agent とは?
読みやすいPythonで書かれたローカルファーストの個人向けAIアシスタント。独自のエージェントループ、SQLiteベースのメモリ、組み込みの評価機能を備えています。 waku-agentは、自分のマシン上で動作する個人向けAIアシスタントです。4つの要素を中心に構成されています。ターミナル、ブラウザダッシュボード、Telegram、Discordなどのゲートウェイを1つのエージェントループにつなぐハーネス、推論・行動・反復を行う約95行のPythonループ、意味記憶・エピソード記憶・手続き記憶(スキル)の各種メモリを扱うシステム、そして決定論的テストとLLM-as-judgeによるスコアリングを組み合わせた評価レイヤーです。
waku-agent は無料で使えますか?ライセンスは?
waku-agent は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
waku-agent は今もメンテナンスされていますか?
活発にメンテナンス中。waku-agent の最終コミットは 2026年10月11日 です。
waku-agent は何に使えますか?
メモリをローカルに保持する個人向けアシスタントをノートPCで動かす 小規模なコードベースで、エージェントループ、メモリ検索、評価がどう連携するかを学ぶ ハーネスをforkして、新しいメッセージングゲートウェイやツールを追加する Waku Memoryを介して、Claude Code、Codexなどのエージェント間でメモリを共有する
waku-agent はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/ShenSeanChen/waku-agent

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト