Credentials. The demo start is safe for testing, but the first start installs dependencies inside the project folder, so review what the script does before running it.
Who it is forA person who is curious about a self-hosted finance tracker and does not want to type real records yet.
The problemSetting up a finance app with real records feels risky before you know how it works.
The outcomeA running local app showing an invented household, with your real data untouched in its own file.
What you need first
- Git installed
- Node.js 22 or later
- uv installed (https://docs.astral.sh/uv/getting-started/installation/)
- macOS, Linux, or Windows with PowerShell
- For the AI advisor only: an OpenRouter account with credit and an API key
Steps
- Install Git, Node.js 22 or later, and uv.
- Run
git clone https://github.com/LosaLosSantos/aurelio-finance.git. - Run
cd aurelio-finance. - On macOS or Linux, run
./start.sh --demo. On Windows in PowerShell, run./start.ps1 -Demo. - Browse the Wealth, Portfolio and Look-through sections to see how the demo data is shown.
Prompt for your agent
In the aurelio-finance repository, start the app with the demo flag for <target OS> and report the URL or screen it opens on. Verify that the app shows an invented household and that backend/data.db is not changed by the demo start.
Caveat. The README says the demo uses a file of its own, so confirm your own backend/data.db is separate before you add real records.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Disclaimer
Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked "Seen in the wild", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email [email protected] and we will look at it promptly. Full disclaimer page