LosaLosSantos/aurelio-finance

Aurelio – AI 기반 개인 재무 관리자

개요 – Aurelio는 모든 재무 데이터를 로컬에 유지하면서 선택적으로 AI 어드바이저와 상담할 수 있는 자체 호스팅 자산 관리 도구입니다. AI 측은 OpenRouter와 통신하며(기본값: Claude Opus 5.5), 질문에 답하고, 웹을 검색하고, 사용자가 확인해야 하는 포트폴리오 변경을 제안할 수 있습니다.

주요 기능

• 데이터 집계 – 현금, 보유 자산, 은행 및 증권 계좌, 부동산, 부채, 정기 투자, 수입/지출 및 목표를 로컬 SQLite 데이터베이스(backend/data.db)에 가져와 저장합니다.
• 포트폴리오 보기 – 비용 기준, 이익, 배당금 및 국가, 섹터, 회사, 통화별 펀드 보유의 룩스루 분석과 함께 시장 가격으로 평가된 포지션을 표시합니다.
• 현금 흐름 및 목표 추적 – 저축률, 각 목표에 필요한 수익률을 계산하고 시간에 따른 현금 흐름을 시각화합니다.
• AI 채팅 어시스턴트 – "Ask 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 라이선스이므로 수정 및 재배포가 가능합니다.

대상 사용자 – 원시 재무 기록을 제3자 서비스에 보내지 않고, 개인 정보 보호 우선의 개인 재무 대시보드와 선택적 AI 기반 인사이트를 원하는 모든 사람.