How to Download and Install Aurelio Finance on Windows

How to Download and Install Aurelio Finance on Windows

Installing Aurelio Finance on Windows is not like installing a normal Windows program. There is no setup wizard and no .exe installer to double click, because the project has no official release builds yet. Instead, you install three free developer tools, get the app’s source code, and launch it with a PowerShell script. It sounds technical, but it is really a short checklist, and most people finish in under half an hour. This guide walks you through every step, from a completely fresh Windows machine to the app running in your browser with demo data.

What the install actually involves

Before you download anything, it helps to see the whole picture. You will do five things: install Git, install Node.js version 22 or newer, install uv, get the Aurelio Finance code, and run the start script. The script does the heavy lifting: it sets up the backend, prepares the frontend, and opens the app at http://localhost:8000 in your browser. Your data will live in a file called backend/data.db inside the project folder, on your own disk.

You will use Windows PowerShell for a few commands. If you have never opened it, press the Windows key, type “PowerShell,” and open Windows PowerShell from the results. You do not need to run it as administrator for any step in this guide.

Step 1: Install Git

Git is the tool that lets you download the app’s source code directly from GitHub, and it makes future updates easy. Here is the simplest path:

  1. Go to git-scm.com and download the 64-bit Windows installer.
  2. Run the installer. The default options are fine for this purpose; you can click through with “Next” and accept the suggested settings.
  3. When it finishes, open a new PowerShell window and type git --version, then press Enter. If you see a version number, Git is ready.

If you would rather not install Git, there is an alternative: the official site aureliofinance.com hosts a zip of the repository on its download page. Download that zip and extract it to a folder like C:\aurelio-finance, and skip ahead to the prerequisites below. The rest of this guide assumes the Git route, but the steps after downloading are identical either way.

Step 2: Install Node.js 22 or newer

Node.js runs the JavaScript side of the app. Aurelio Finance needs version 22 or newer, so grab a current release:

  1. Go to nodejs.org and download the LTS (long-term support) version for Windows. As long as the major version is 22 or higher, you are fine.
  2. Run the installer and accept the defaults. It will add Node.js to your system PATH, which means PowerShell can find it afterward.
  3. Open a fresh PowerShell window and run node --version. You should see something like v22.x.x or higher. If PowerShell says the command is not recognized, close all PowerShell windows and open a new one so the updated PATH takes effect.

A quick note: the Node.js installer may offer to install extra tools for native modules. You do not need those for Aurelio Finance, so you can skip that checkbox.

Step 3: Install uv

uv is a fast Python package manager that the app’s backend relies on. The official installer for Windows is a single PowerShell command. Open PowerShell and run:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

After it finishes, close PowerShell, open a new window, and run uv --version to confirm it installed. If the version prints, you have everything the app needs.

Step 4: Get the Aurelio Finance code

Pick a home for the project. Your user folder or the root of your C: drive both work; avoid paths with spaces if you can, since they occasionally complicate scripts. In PowerShell:

  1. Move to where you want the folder, for example cd C:\.
  2. Clone the repository: git clone https://github.com/LosaLosSantos/aurelio-finance.git
  3. Move into it: cd aurelio-finance

Cloning with Git has a lasting advantage: when the project updates, you can pull the latest code with a single git pull command instead of re-downloading a zip.

Step 5: Run the start script

This is the moment it all comes together. In PowerShell, from inside the project folder, run:

.\start.ps1 -Demo

The -Demo flag starts the app in demo mode, which loads invented sample data so you can explore safely. The first run takes a few minutes because the script sets up the backend environment and installs dependencies. Later starts are much faster.

When it is ready, the app opens at http://localhost:8000 in your browser. Click around freely: check the net worth dashboard, open the portfolio views, look at the cash flow and goals pages. Nothing here is real, so you cannot break anything that matters.

If PowerShell blocks the script

Windows sometimes refuses to run downloaded scripts, and you will see an error about execution policies. This is Windows protecting you from scripts you did not mean to run, and there is a safe way past it for a script you trust. Instead of changing your system policy permanently, run it once with a bypass for just that command:

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

This applies the bypass to that single run only. Your system’s normal policy stays exactly as it was, which is the outcome you want.

Try demo mode before anything else

Demo mode deserves emphasis, because it is the smart way to learn the app. The sample data is realistic enough to show you how net worth tracking, investment look-through, and cash flow pages behave, but it is entirely fictional. Spend twenty minutes clicking through every section. If something confuses you, that is useful information: better to learn the layout with fake numbers than to fumble with your real finances on screen.

When you close the terminal or press Ctrl+C in the PowerShell window, the app stops. Your computer goes back to normal, and nothing lingers in the background.

Switching to your real data

When you are comfortable with the layout, starting with real data is a one-word change: run the same script without the demo flag.

.\start.ps1

The app starts empty, and everything you enter is stored in backend/data.db inside the project folder. That file is your financial record now, so treat it accordingly: the app automatically saves a backup copy next to it before any update that changes the data format, but you should still copy that file to a safe place regularly, like an external drive or an encrypted backup. There is no cloud copy. If the file is lost and you have no backup, the data is gone.

Take your time entering your real numbers. Start with the big pieces: bank balances, investment accounts, outstanding debts. You can refine the details over the following days. A personal finance tool is most useful when it is complete enough to trust, and trust builds faster when you are not rushing.

When something goes wrong

Most installation problems on Windows come from a short list of causes. Work through these before anything else:

  • “node is not recognized.” The Node.js installer updated your PATH, but your PowerShell window opened before that. Close every PowerShell window and open a fresh one.
  • “uv is not recognized.” Same story: open a new PowerShell window after installing uv so the PATH refresh takes effect.
  • The script fails on first run. The first start downloads and builds dependencies, so a shaky internet connection can interrupt it. Check your connection and run the script again; it picks up where it left off.
  • Port 8000 is already in use. Another program on your machine may be holding that port. Close the other program, or stop any earlier Aurelio Finance run still sitting in a terminal window.
  • Your antivirus flags the script. Some antivirus tools are suspicious of PowerShell scripts in general. If you downloaded the code from the official GitHub repository, the script is exactly what the project’s authors published. You can review start.ps1 in any text editor before running it; open-source code means there is nothing hidden.

If you are still stuck after these checks, the fixes guide linked below covers the most common failures in more depth, including how to read the error output the script prints.

A quick word on what you just installed

Take a step back and notice what you did not do: you did not create an account, agree to a subscription, or hand your financial data to a company. The app runs on your machine, your data file sits in your project folder, and the whole thing works offline. That independence is the point of Aurelio Finance. The small effort of this setup buys you a finance tool that nobody can reprice, redesign against your will, or shut down.

Read next

2 thoughts on “How to Download and Install Aurelio Finance on Windows”

  1. Pingback: Is aurelio finance Safe? Privacy and Data Explained

  2. Pingback: aurelio finance Not Working? Problems and Fixes

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top