aurelio-finance

环境要求

• 已安装 Git
• 已安装 Node.js 22 或更高版本
• 已安装 uv（Python 包/环境管理工具）
• macOS / Linux 使用终端，Windows 使用 PowerShell

安装与启动步骤

1. 1准备运行环境

   先装好 Git、Node.js 22+ 和 uv，三者缺一不可；README 只给出官网链接，未给安装命令。

2. 2克隆项目仓库

   把 aurelio-finance 源码下载到本地任意目录，网络不通时可用代理重试。

   git clone https://github.com/LosaLosSantos/aurelio-finance.git

   复制

3. 3进入项目目录

   后续所有启动命令都必须在这个仓库根目录下执行，不要进到 backend 等子目录。

   cd aurelio-finance

   复制

4. 4用演示数据启动

   macOS/Linux 首次启动会在目录内自动安装依赖，并用一套虚构的家庭数据打开页面。

   ./start.sh --demo

   复制

5. 5Windows 演示启动

   Windows 在 PowerShell 中改用 ps1 脚本，参数写法是 -Demo，不是 --demo。

   ./start.ps1 -Demo

   复制

6. 6用真实数据启动

   去掉 demo 参数即以你自己的数据启动，数据库文件随首次运行生成。

   ./start.sh

   复制

7. 7绕过脚本执行限制

   若 PowerShell 提示禁止运行脚本，用这条命令显式以 Bypass 策略执行启动脚本。

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

   复制

关键配置

如何确认成功

首次启动完成后浏览器访问 http://localhost:8000，能看到虚构或自己的资产面板即成功。

常见问题

注意事项

• Node.js 必须为 22 或更高版本，低于该版本不支持。
• Windows 的命令行参数与 macOS/Linux 不同：用 -Demo 而非 --demo。
• Web 界面固定为 http://localhost:8000，请确认该端口未被占用。
• 演示数据保存在单独的文件里，不会污染你自己的真实记录。