aurelio-finance README

The project's README from github.com/LosaLosSantos/aurelio-finance. As one markdown file: README.md.

Aurelio

CI

Aurelio is a wealth-management and financial-planning app that runs on your own computer, with an AI advisor you can talk to. Your records are kept on your machine. The AI part is optional: it goes through OpenRouter with your own key.

Aurelio: everything you own in one place. An animation: the net worth and what makes it up, the countries inside the funds, a question about 1,235 euros left each month answered with a split, and a proposal you confirm or reject.

Try it on invented data

You need Git, Node.js 22 or later and uv. Then:

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.sh --demo          # macOS and Linux

git clone https://github.com/LosaLosSantos/aurelio-finance.git
cd aurelio-finance
./start.ps1 -Demo          # Windows, in PowerShell

If PowerShell says that running scripts is disabled, use powershell -ExecutionPolicy Bypass -File .\start.ps1 -Demo.

The first start installs what it needs inside the folder and opens http://localhost:8000 on an invented household, kept in a file of its own. Start without the flag to use your own data.

Run it on your own data

./start.sh                 # macOS and Linux

./start.ps1                # Windows

Your records live in backend/data.db. Before an update changes its format, the app saves a copy next to it.

What it does

How Aurelio reasons explains the ideas underneath.

The AI part

  1. Create an account at https://openrouter.ai, add credit, and create a key at https://openrouter.ai/keys.
  2. Copy backend/.env.example to backend/.env and set OPENROUTER_API_KEY.

The default model is Claude Opus 5.5 ($4 per million input tokens, $20 per million output tokens); you can pick another in the chat. What it cost, measured in October 2026 (the chat's rows on 10 October, a web search on 9 October, on a test database):

cost
A first question that drew two cards, answered in one round $0.11
A follow-up, answered in one round $0.028
A follow-up that drew a card, answered in one round $0.013 to $0.020
Confirming a card, with the reply after it $0.026 to $0.057
Each web search, on top of the round that asked for it $0.0073 to $0.0075
An analysis $0.33 to $0.51

Development

uv run pytest in backend/ and npm test in frontend/. For hot reload, run uv run uvicorn app.main:app --port 8000 in backend/ and npm run dev in frontend/.

License

MIT, see LICENSE.

aurelio-finance (LosaLosSantos/aurelio-finance)

Searching Database…

3.9K ·GitHub
Aurelio-finance
Что это?Aurelio — самохостящееся приложение личных финансов, которое отслеживает ваш собственный капитал, инвестиции, ETF, наличные и долги, плюс опциональный ИИ-финансовый советник, с которым можно общаться в чате.
Это настольное приложение или то, что открывается в браузере?Это локальное веб-приложение: бэкенд на Python/FastAPI и фронтенд на React/TypeScript работают на вашей машине, а пользуетесь вы им через браузер.
Как его запустить?Клонируйте репозиторий и запустите стартовый скрипт (например, `powershell -ExecutionPolicy Bypass -File .\start.ps1 -Demo`); при первом запуске всё нужное устанавливается внутри папки проекта, и приложение открывается.
Что нужно установить перед запуском?Перед запуском стартового скрипта нужно установить Git, Node.js 22 или новее и uv (менеджер пакетов Python).
Платно ли пользоваться ИИ-советником?ИИ-чат опционален и тарифицируется за каждый запрос через ваш собственный ключ OpenRouter; модель по умолчанию Claude Opus 5.5 стоила около $0.11 за первый вопрос и $0.33–$0.51 за полный анализ по состоянию на октябрь 2026 года.
Где хранятся мои финансовые данные?Ваши финансовые записи остаются на вашем компьютере; покидает его только трафик опционального ИИ-чата, отправляемый через ваш собственный ключ OpenRouter.
Что показывает функция look-through?Она раскладывает по странам, секторам, компаниям и валютам то, что ваши фонды на самом деле держат за своим тикером, вместо простого показа самого фонда.
Как чат Ask Aurelio вносит изменения в мои данные?Он отвечает на основе ваших собственных записей, умеет искать в интернете и предлагает каждое изменение карточкой, которую нужно подтвердить или отклонить, прежде чем что-либо применится.
Почему в анализе две ИИ-персоны?Персона-аналитик и «доверенное лицо, которое вас знает» обсуждают ваш портфель с разных сторон, а затем этап синтеза подсказывает, на что смотреть в первую очередь.
Можно попробовать без ввода реальных счетов?Да, запуск стартового скрипта с флагом -Demo открывает Aurelio, заранее наполненную вымышленными данными вместо ваших реальных финансов.
What are similar projects?Aurum, firefly-iii, actual, QuantDinger, nofx, daily_stock_analysis, trade-journal, sure
Which topics is it in?money, budgeting, stocks, accounting, personal-finance, fintech, openrouter, fastapi, finance, openai-compatible, dashboard, database
Creator
LosaLosSantos
Size
12.6 MB
Stars
3.9K
Updated
CommitOct 16
Age
11d
Commits · 90 Days