Aurelioチュートリアル：プライベートなAI搭載資産管理アプリをローカルで実行する

Aurelioとは？

Aurelioは、セルフホスト型の資産管理・ファイナンシャルプランニングアプリケーションです。自分のコンピューター上で動作し、金融記録をローカルに保存しながら、ポートフォリオ、キャッシュフロー、目標、計画、住宅、負債のダッシュボードを提供します。

オプションのAIアドバイザーを使うと、記録について質問したり、ウェブを検索したり、確認または却下できるカード形式の変更案を受け取ったりできます。AIリクエストには、ユーザー自身のOpenRouterアカウントとAPIキーを使用します。

Aurelioは、コンピューター上で個人利用するために設計されています。記録はbackend/data.dbにローカル保存されます。

主な機能

• 資産管理：銀行、証券会社、現金、保有資産を表す日付付きの状況を管理できます。
• ポートフォリオ分析：市場価格に基づくポジションを確認できます。取得原価、損益、配当も表示されます。
• ファンドの内訳分析：ファンドの保有銘柄を国、セクター、企業、通貨別に確認できます。
• 計画、住宅、負債：定期投資、実物資産、それらの購入資金となるローンを管理できます。
• キャッシュフローと目標：収入、支出、貯蓄率、各目標に必要なリターンを確認できます。
• Aurelioに質問：記録を利用し、ウェブ検索もできるAIアドバイザーとチャットできます。承認用の変更案も提示されます。
• 分析：アナリストと相談相手それぞれの視点を比較し、最初に検討すべき内容をまとめて確認できます。

アプリケーションの背景にある概念については、Aurelioの推論方法をお読みください。

前提条件

Aurelioをインストールする前に、次のツールがあることを確認してください。

• Git
• Node.js 22以降
• uv

付属の起動スクリプトは、初回起動時に必要な依存関係をプロジェクトフォルダー内へインストールします。

インストールしてデモを試す

最初は、Aurelioに用意された架空の世帯で始めるのが安全です。自分の金融情報を入力せずにインターフェースを試せます。

macOSとLinux

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.sh --demo

Windows PowerShell

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.ps1 -Demo

PowerShellでスクリプトの実行が無効になっていると報告された場合は、実行ポリシーを上書きしてスクリプトを実行してください。

powershell -ExecutionPolicy Bypass -File .\start.ps1 -Demo

初回起動後、Aurelioはhttp://localhost:8000で開きます。デモ用の世帯は別ファイルに保存されるため、自分のデータに影響を与えずに試せます。

ポートフォリオと記録を確認する

ポートフォリオビューでは、市場価格に基づくポジションと、取得原価、損益、配当を確認できます。

内訳分析ビューでは、ファンドの保有内容を詳しく確認できます。国、セクター、企業、通貨別のエクスポージャーを調べられます。

記録には、個別の口座について日付付きの状況を含めることができます。これにより、特定の時点で何を保有していたかを表現できます。

自分のデータでAurelioを使う

デモに慣れたら、アプリケーションを停止し、デモオプションなしで起動してください。

macOSとLinux

./start.sh

Windows PowerShell

./start.ps1

記録はbackend/data.dbに保存されます。データベース形式が変更されるアップデートでは、変更を適用する前にAurelioがデータベースのコピーを同じ場所に保存します。

このアプリケーションは金融情報を扱うため、Aurelioを実行するコンピューターとフォルダーを保護してください。READMEにはローカル保存について記載されていますが、ホスト型の同期サービスやバックアップサービスは提供されません。

オプションのAIアドバイザーを有効にする

AI機能はオプションです。AIプロバイダーを設定せずに、ローカルの資産管理機能を利用できます。

1. OpenRouterでアカウントを作成し、クレジットを追加します。
2. OpenRouter KeysでAPIキーを作成します。
3. リポジトリのルートから、backend/.env.exampleをbackend/.envにコピーします。
4. backend/.envのOPENROUTER_API_KEYの値を設定します。

OPENROUTER_API_KEY=your_openrouter_key

環境ファイルを変更した後は、Aurelioを再起動して新しい設定を読み込ませてください。

デフォルトモデルはClaude Opus 5.5で、チャット内で別のモデルを選択できます。READMEには、2026年10月に計測した費用例として、1ラウンドで回答する最初の質問が約$0.11、1ラウンドで回答するフォローアップが$0.017、ウェブ検索を1回使ったアドバイスが$0.16、分析が$0.33～$0.51と記載されています。実際の費用は変動する可能性があるため、OpenRouterアカウントと選択したモデルを確認してください。

質問して提案された変更を確認する

APIキーを設定したら、チャットを使って自分の記録に基づく質問をできます。外部情報が必要なリクエストでは、Aurelioがウェブを検索することもできます。

アシスタントが変更を提案した場合は、適用する前に確認してください。アプリケーションは、記録を黙って変更するのではなく、確認または拒否できるカードとして提案を表示します。

この確認手順は、財務データに対して特に重要です。承認する前に、提案された口座、日付、金額、その他の詳細が意図と一致していることを確認してください。

開発とテスト

Aurelio自体を開発したい場合、プロジェクトにはバックエンドとフロントエンド向けに個別のワークフローが用意されています。

バックエンドのテストを実行する

backend/ディレクトリから次を実行します。

uv run pytest

フロントエンドのテストを実行する

frontend/ディレクトリから次を実行します。

npm test

ホットリロードを有効にする

バックエンドのホットリロードを有効にするには、backend/内で次のコマンドを実行します。

uv run uvicorn app.main:app --port 8000

フロントエンドの開発サーバーを起動するには、frontend/内で次のコマンドを実行します。

npm run dev

実用的なヒント

• デモモードから始める: 個人の記録を入力する前に、--demoまたは-Demoを使用します。
• AIは任意にする: チャット、ウェブ検索を利用した回答、分析を使いたい場合にのみOpenRouterを設定します。
• すべての提案を確認する: 記録を変更する前に、チャットカードを慎重に確認または拒否します。
• モデルの費用を確認する: 選択したモデルとリクエストの種類がOpenRouterの利用量に影響します。
• データベースを保持する: backend/data.dbと、フォーマット更新時にAurelioが作成するコピーを管理します。
• 推論ガイドを利用する: 分析の仕組みについてプロジェクトが説明している内容を読み、想定されたワークフローを理解します。

まとめ

Aurelioは、ローカルでの財務記録管理と任意のAI支援を組み合わせています。リポジトリをクローンし、用意されたデモ世帯を起動してポートフォリオビューとルックスルービューを確認してから、デモモードを使わずに自分のデータでアプリケーションを実行してください。対話形式のガイダンスが必要な場合は、OpenRouterキーを追加し、提案された各変更を承認する前に確認してください。AurelioはMITライセンスの下で公開されています。