sakowicz/actual-ai

解決する課題

Actual AI は、Actual Budget 用の自動取引分類ツールです。大規模言語モデル（LLM）を活用して取引の詳細を分析し、最も適切なカテゴリを提案することで、未分類の取引にカテゴリを手動で割り当てる手間をなくします。

動作方法

アプリケーションは Actual Budget サーバーに接続し、カテゴリのない取引を識別します。取引の説明、金額、メモを、設定された LLM プロバイダー（OpenAI、Anthropic、Google、Ollama など）に送信します。その後、LLM は既存のカテゴリ構造に基づいて取引を分類します。

主な機能は以下の通りです：

• Web 検索統合：ValueSerp API を使用して、 unfamiliar な業者についてインターネット検索を行い、LLM に分類のためのより良い文脈を提供します。
• カテゴリ拡張：取引が既存のカテゴリに当てはまらない場合、LLM は新しいカテゴリを提案し、自動的に作成できます。
• スケジューリング：cron スケジュールや起動時に実行可能で、予算を最新の状態に保つことができます。
• レビュー機能：すべての推測された取引はメモに「guessed」とマークされ、失敗した試行は「not guessed」とマークされるため、ユーザーが変更内容を確認できます。

対象ユーザー

手動での取引分類に時間をかけたくない、財務管理を自動化したい Actual Budget のユーザー。

特徴

• 複数の LLM 対応：OpenAI、Anthropic、Google Generative AI、Ollama、OpenRouter、Groq に対応。
• 知能的な分類：支払い先、金額、日付などの取引メタデータとカスタムプロンプトを使用してカテゴリを決定。
• Web 拡張文脈：オンラインで業者情報を検索し、珍しい企業の分類精度を向上。
• 自動カテゴリ作成：現在のグループに当てはまらない取引に対して、知的に新しいカテゴリを提案・作成可能。
• 安全最優先：「ドライラン」モードを備えており、実際の予算データを変更せずに提案された変更をログに記録できます。