smixs/iva-agent

これは何？

主な機能

• 01Deepgramで音声メモを文字起こしし、モデルのvision機能で写真を説明します。
• 02毎日のメッセージをMarkdownで原文のまま保存し、週、月、年単位の要約にまとめます。
• 03すべてのプロンプトに含めるCORE.mdファイルで、継続的なコンテキストを保持します。
• 04BM25とリンクグラフによる再ランキングを使って記憶を検索でき、オプションでベクトル検索も利用できます。
• 05タスク、リマインダー、日次ブリーフを管理します。
• 06gws CLI経由でGmail、Calendar、Drive、Sheets、Docs、Tasksに接続でき、MCPサーバーとskillsにも対応します。

ユースケース

• 数か月前にクライアントと合意した内容を思い出す。
• 長い音声メモからタスクリスト、メールの下書き、会議カードを作成する。
• Telegram内で連絡先やフォローアップを管理する個人用CRMを作る。
• データを自分のサーバーに保管する、セルフホスト型の個人アシスタントを運用する。

クイックスタート

1. 1

   BotFatherからボットトークンを取得します

2. 2

   リポジトリをクローンします

   git clone https://github.com/smixs/iva-agent.git ~/iva
3. 3

   クローンしたリポジトリからインストーラーを実行し、質問に回答します

   cd ~/iva && bash install.sh
4. 4

   セットアップを完了するため、ボットにメッセージを送ります

使う前に知っておきたいこと

• !Node.js 24以降と自分で運用するサーバーが必要なため、セルフホスティングの手間がかかります。
• !モデルプロバイダーのAPIキーまたはサブスクリプションが必要です。モデルと文字起こしの呼び出しは、有料のクラウドAPIに送信されます。
• !オプションのuserbot機能はTelegramの利用規約に違反しており、アカウントが制限または停止される可能性があります。

トピック

よくある質問

iva-agent とは？

音声メモ、写真、メッセージを検索可能なMarkdownの記憶庫に保存する、セルフホスト型Telegram AIアシスタント。 Ivaは、自分のサーバー上で動作するTelegram AIアシスタントです。メッセージ、音声メモ、写真、PDF、転送された投稿は、日付ごとのプレーンなMarkdownファイルとしてObsidian互換のvaultに保存されます。また、連絡先、プロジェクト、決定事項、メモのカードが蓄積されていきます。

iva-agent は無料で使えますか？ライセンスは？

iva-agent は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

iva-agent は今もメンテナンスされていますか？

活発にメンテナンス中。iva-agent の最終コミットは 2026年10月22日 です。

iva-agent は何に使えますか？

数か月前にクライアントと合意した内容を思い出す。 長い音声メモからタスクリスト、メールの下書き、会議カードを作成する。 Telegram内で連絡先やフォローアップを管理する個人用CRMを作る。 データを自分のサーバーに保管する、セルフホスト型の個人アシスタントを運用する。

iva-agent のインストール方法は？

BotFatherからボットトークンを取得します リポジトリをクローンします: git clone https://github.com/smixs/iva-agent.git ~/iva クローンしたリポジトリからインストーラーを実行し、質問に回答します: cd ~/iva && bash install.sh セットアップを完了するため、ボットにメッセージを送ります

iva-agent はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/smixs/iva-agent