Hướng dẫn Aurelio: Chạy ứng dụng quản lý tài sản riêng tư tích hợp AI trên máy cá nhân

Aurelio là gì?

Aurelio là ứng dụng quản lý tài sản và lập kế hoạch tài chính tự lưu trữ. Ứng dụng chạy trên máy tính của bạn, lưu hồ sơ tài chính cục bộ và cung cấp bảng điều khiển cho danh mục đầu tư, dòng tiền, mục tiêu, kế hoạch, nhà ở và các khoản nợ.

Cố vấn AI tùy chọn cho phép bạn đặt câu hỏi về hồ sơ của mình, tìm kiếm trên web và nhận các thay đổi được đề xuất dưới dạng thẻ để bạn xác nhận hoặc từ chối. Các yêu cầu AI sử dụng tài khoản OpenRouter và khóa API của bạn.

Aurelio được thiết kế để sử dụng cá nhân trên máy tính của bạn. Hồ sơ của bạn được lưu cục bộ tại backend/data.db.

Tính năng chính

• Theo dõi tài sản: Quản lý ngân hàng, công ty môi giới, tiền mặt và các tình huống theo ngày mô tả những gì bạn đang nắm giữ.
• Phân tích danh mục đầu tư: Xem các vị thế được định giá theo thị trường, bao gồm giá vốn, lợi nhuận và cổ tức.
• Phân tích xuyên suốt quỹ: Xem xét các khoản nắm giữ của quỹ theo quốc gia, lĩnh vực, công ty và tiền tệ.
• Kế hoạch, nhà ở và các khoản nợ: Theo dõi các khoản đầu tư định kỳ, tài sản thực và các khoản vay tài trợ cho chúng.
• Dòng tiền và mục tiêu: Xem xét thu nhập, chi tiêu, tỷ lệ tiết kiệm và mức lợi nhuận cần thiết cho từng mục tiêu.
• Hỏi Aurelio: Trò chuyện với cố vấn AI sử dụng hồ sơ của bạn, có thể tìm kiếm trên web và đề xuất các thay đổi để bạn phê duyệt.
• Phân tích: So sánh góc nhìn của một nhà phân tích và một người đáng tin cậy, sau đó tổng hợp những điều cần xem xét trước tiên.

Để tìm hiểu các khái niệm làm nền tảng cho ứng dụng, hãy đọc Cách Aurelio lập luận.

Điều kiện tiên quyết

Trước khi cài đặt Aurelio, hãy đảm bảo bạn có các công cụ sau:

• Git
• Node.js 22 trở lên
• uv

Tập lệnh khởi động đi kèm sẽ cài đặt các phần phụ thuộc cần thiết vào thư mục dự án trong lần chạy đầu tiên.

Cài đặt và dùng thử bản demo

Cách an toàn nhất để bắt đầu là sử dụng hộ gia đình giả lập của Aurelio. Bạn có thể khám phá giao diện mà không cần nhập thông tin tài chính của mình.

macOS và 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

Nếu PowerShell báo rằng việc chạy tập lệnh bị vô hiệu hóa, hãy chạy tập lệnh với tùy chọn ghi đè chính sách thực thi:

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

Sau lần khởi động đầu tiên, Aurelio mở tại http://localhost:8000. Hộ gia đình demo được lưu trong một tệp riêng, vì vậy bạn có thể khám phá mà không ảnh hưởng đến dữ liệu của mình.

Khám phá danh mục đầu tư và hồ sơ

Màn hình Danh mục đầu tư hiển thị các vị thế được định giá theo thị trường, cùng với giá vốn, lợi nhuận và cổ tức.

Chế độ xem xuyên suốt cung cấp thêm thông tin chi tiết về các khoản nắm giữ của quỹ. Bạn có thể xem mức độ phân bổ theo quốc gia, lĩnh vực, công ty và tiền tệ.

Hồ sơ có thể bao gồm các tình huống theo ngày cho từng tài khoản. Nhờ đó, bạn có thể biểu diễn những gì mình nắm giữ tại một thời điểm cụ thể.

Sử dụng Aurelio với dữ liệu của bạn

Sau khi đã quen với bản demo, hãy dừng ứng dụng rồi khởi động lại mà không có tùy chọn demo.

macOS và Linux

./start.sh

Windows PowerShell

./start.ps1

Hồ sơ của bạn được lưu tại backend/data.db. Khi một bản cập nhật dự kiến sẽ thay đổi định dạng cơ sở dữ liệu, Aurelio sẽ lưu một bản sao cạnh cơ sở dữ liệu trước khi áp dụng thay đổi.

Vì ứng dụng này xử lý thông tin tài chính, hãy bảo vệ máy tính và thư mục nơi Aurelio chạy. README mô tả việc lưu trữ cục bộ, nhưng không cung cấp dịch vụ đồng bộ hóa lưu trữ hoặc dịch vụ sao lưu.

Bật cố vấn AI tùy chọn

Chức năng AI là tùy chọn. Bạn có thể sử dụng các tính năng quản lý tài chính cục bộ mà không cần cấu hình nhà cung cấp AI.

1. Tạo tài khoản tại OpenRouter và nạp tín dụng.
2. Tạo khóa API tại OpenRouter Keys.
3. Từ thư mục gốc của kho mã, sao chép backend/.env.example thành backend/.env.
4. Đặt giá trị OPENROUTER_API_KEY trong backend/.env.

OPENROUTER_API_KEY=your_openrouter_key

Khởi động lại Aurelio sau khi thay đổi tệp môi trường để ứng dụng có thể đọc cấu hình mới.

Mô hình mặc định là Claude Opus 5.5 và bạn có thể chọn mô hình khác trong phần trò chuyện. README báo cáo chi phí mẫu được đo vào tháng 10 năm 2026: khoảng 0,11 USD cho câu hỏi đầu tiên được trả lời trong một lượt, 0,017 USD cho câu hỏi tiếp theo được trả lời trong một lượt, 0,16 USD cho lời khuyên kèm một lần tìm kiếm trên web và 0,33 đến 0,51 USD cho một lần phân tích. Chi phí thực tế có thể thay đổi, vì vậy hãy kiểm tra tài khoản OpenRouter và mô hình đã chọn.

Đặt câu hỏi và xem xét các thay đổi được đề xuất

Sau khi cấu hình khóa API, hãy sử dụng phần trò chuyện để đặt câu hỏi dựa trên dữ liệu của riêng bạn. Aurelio cũng có thể tìm kiếm trên web khi yêu cầu cần thông tin bên ngoài.

Khi trợ lý đề xuất một thay đổi, hãy xem xét thay đổi đó trước khi áp dụng. Ứng dụng hiển thị đề xuất dưới dạng thẻ để bạn xác nhận hoặc từ chối, thay vì âm thầm sửa đổi dữ liệu của bạn.

Bước xác nhận này đặc biệt quan trọng đối với dữ liệu tài chính: hãy kiểm tra để bảo đảm tài khoản, ngày, số tiền hoặc các chi tiết khác trong đề xuất khớp với ý định của bạn trước khi chấp nhận.

Phát triển và kiểm thử

Nếu muốn làm việc trên chính Aurelio, dự án có các quy trình riêng cho backend và frontend.

Chạy kiểm thử backend

Từ thư mục backend/, chạy:

uv run pytest

Chạy kiểm thử frontend

Từ thư mục frontend/, chạy:

npm test

Bật tự động tải lại

Để bật tự động tải lại cho backend, hãy chạy lệnh sau trong backend/:

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

Để chạy máy chủ phát triển frontend, hãy chạy lệnh này trong frontend/:

npm run dev

Mẹo thực tế

• Bắt đầu với chế độ demo: Sử dụng --demo hoặc -Demo trước khi nhập dữ liệu cá nhân.
• Để AI là tùy chọn: Chỉ cấu hình OpenRouter nếu bạn muốn sử dụng trò chuyện, câu trả lời có hỗ trợ tìm kiếm trên web hoặc tính năng phân tích.
• Xem xét mọi đề xuất: Cẩn thận xác nhận hoặc từ chối các thẻ trò chuyện trước khi thay đổi dữ liệu của bạn.
• Theo dõi chi phí mô hình: Mô hình được chọn và loại yêu cầu ảnh hưởng đến mức sử dụng OpenRouter.
• Bảo toàn cơ sở dữ liệu: Hãy theo dõi backend/data.db và các bản sao Aurelio tạo trong quá trình cập nhật định dạng.
• Sử dụng hướng dẫn suy luận: Đọc phần giải thích của dự án về cách thức hoạt động của tính năng phân tích để hiểu quy trình dự kiến.

Kết luận

Aurelio kết hợp việc lưu trữ hồ sơ tài chính cục bộ với sự hỗ trợ AI tùy chọn. Hãy sao chép kho lưu trữ, khởi chạy hộ gia đình demo đã tạo, kiểm tra các chế độ xem danh mục và xem chi tiết, sau đó chạy ứng dụng không có chế độ demo để sử dụng dữ liệu của riêng bạn. Nếu muốn được hướng dẫn qua hội thoại, hãy thêm khóa OpenRouter và xem xét từng thay đổi được đề xuất trước khi chấp nhận. Aurelio được phát hành theo Giấy phép MIT.