LosaLosSantos/aurelio-finance

Aurelio – AI を活用した個人財務マネージャー

概要 – Aurelio はセルフホスト型の資産管理ツールで、すべての財務データをローカルに保持しながら、オプションで AI アドバイザーに相談できます。AI 側は OpenRouter と通信し（デフォルトは Claude Opus 5.5）、質問への回答、ウェブ検索、確認が必要なポートフォリオ変更の提案を行うことができます。

主な機能

• データ集約 – 現金、保有資産、銀行・証券口座、不動産、負債、定期投資、収入・支出、目標をローカルの SQLite データベース（backend/data.db）にインポートして保存します。
• ポートフォリオビュー – 市場価格で評価されたポジションを、コストベース、利益、配当、およびファンド保有の国・セクター・企業・通貨別の ルックスルー 内訳とともに表示します。
• キャッシュフローと目標追跡 – 貯蓄率、各目標に必要なリターンを計算し、キャッシュフローを時系列で可視化します。
• AI チャットアシスタント – 「Ask Aurelio」を使用すると、自分の記録を照会し、ウェブ検索を実行し、確認可能なカードとして提示される推奨アクションを受け取ることができます。
• アナリスト–腹心の対話 – 内部推論モジュールが 2 つの仮想エージェント（アナリストと腹心）を実行し、ポートフォリオについて議論させ、最初に確認すべき項目の簡潔な総合を生成します。

試用方法

1. Git、Node 22+、Python パッケージマネージャー uv をインストールします。
2. リポジトリをクローンし、./start.sh --demo（Windows では ./start.ps1 -Demo）を実行して、http://localhost:8000 でデモ世帯を起動します。
3. --demo フラグを省略すると、backend/data.db に保存された自分のデータを読み込みます。

AI の有効化

• openrouter.ai でサインアップし、API キーを取得し、backend/.env.example を backend/.env にコピーして、OPENROUTER_API_KEY を設定します。
• デフォルトモデルは Claude Opus 5.5 です。コストは README に記載されています（1 回の質問で約 $0.11）。

開発メモ

• バックエンド: Python（uv、FastAPI、Uvicorn）– テストは uv run pytest で実行します。
• フロントエンド: Node/React – npm run dev でホットリロード、npm test でユニットテストを実行します。
• MIT ライセンスなので、変更や再配布が可能です。

対象ユーザー – 生の財務記録を第三者サービスに送信せずに、プライバシー優先の個人財務ダッシュボードと、オプションの AI 駆動インサイトを求めるすべての人。