LosaLosSantos/aurelio-finance

Aurelio – AI 驱动的个人财务管理工具

它是什么 – Aurelio 是一款自托管的财富管理工具，让您将所有财务数据保存在本地，同时可选使用 AI 顾问。AI 端与 OpenRouter 通信（默认为 Claude Opus 5.5），可以回答问题、搜索网络，并建议您必须确认的投资组合变更。

主要功能

• 数据汇总 – 将现金、持股、银行和券商账户、房地产、债务、定期投资、收入/支出和目标导入并存储在本地 SQLite 数据库（backend/data.db）中。
• 投资组合视图 – 显示按市场价格计价的持仓，包含成本基础、收益、股息，以及基金持股按国家、行业、公司和货币的 透视 明细。
• 现金流与目标跟踪 – 计算储蓄率、每个目标所需的回报率，并随时间可视化现金流。
• AI 聊天助手 – “询问 Aurelio” 可让您查询自己的记录、执行网络搜索，并接收以可确认卡片呈现的建议操作。
• 分析师–知己对话 – 内部推理模块运行两个虚拟代理（分析师和知己），他们辩论您的投资组合，并生成简洁的综合摘要，说明应优先审查哪些项目。

如何试用

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 中（单轮问题约 $0.11）。

开发备注

• 后端：Python（uv、FastAPI、Uvicorn）– 使用 uv run pytest 运行测试。
• 前端：Node/React – 通过 npm run dev 热重载，并使用 npm test 运行单元测试。
• 采用 MIT 许可证，因此您可以修改和重新分发。

适合对象 – 任何想要隐私优先的个人财务仪表板，并可选使用 AI 驱动的洞察，而无需将原始财务记录发送给第三方服务的人。