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 키에서 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 라이선스로 배포됩니다.