跳到主要内容
AI教程

Aurelio 教程：在本地运行私有 AI 驱动的财富管理应用

了解如何安装 Aurelio、探索其演示家庭，将其连接到您自己的财务记录，并根据需要配置 OpenRouter，以使用 AI 辅助提问、分析和提出更改建议。

AI我搜编辑部阅读约 7 分钟
Aurelio 教程：在本地运行私有 AI 驱动的财富管理应用

Aurelio 是什么？

Aurelio 是一款自托管的财富管理和财务规划应用。它运行在你自己的计算机上，将财务记录保存在本地，并提供用于查看投资组合、现金流、目标、计划、房产和债务的仪表板。

可选的 AI 顾问可以让你询问有关记录的问题、搜索网页，并将建议的更改以卡片形式展示，供你确认或拒绝。AI 请求使用你自己的 OpenRouter 账户和 API 密钥。

Aurelio 专为在个人计算机上使用而设计。你的记录保存在本地的 backend/data.db 中。

主要功能

  • 财富跟踪：管理银行、券商、现金，以及描述你所持资产的带日期情境。
  • 投资组合分析：查看按市场价格计算的持仓，包括成本、收益和股息。
  • 基金穿透分析：按国家、行业、公司和货币查看基金持仓。
  • 计划、房产和债务：跟踪定期投资、实物资产及其融资贷款。
  • 现金流和目标：查看收入、支出、储蓄率，以及每个目标所需的回报率。
  • 询问 Aurelio：与 AI 顾问聊天。它会使用你的记录、搜索网页，并提出供你批准的更改。
  • 分析：比较分析师和知己的观点，然后综合得出最先需要审视的事项。

如需了解应用背后的概念，请阅读 Aurelio 如何进行推理。

前置要求

安装 Aurelio 前，请确保你已安装以下工具：

首次启动时，随附的启动脚本会在项目文件夹中安装所需依赖。

投资组合

安装并试用演示

最稳妥的开始方式是使用 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 月测得的示例费用：单轮回答第一个问题约为 0.11 美元，单轮回答后续问题约为 0.017 美元，进行一次网络搜索并提供建议约为 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 许可证发布。