freemace 0.8.0

Freelance budgeting app

A self-hosted freelance budgeting app with a React UI, FastAPI backend, automatic git backup to GitHub, and over-the-air updates from PyPI.

Quick Install

One-liner that sets up everything (venv, service, auto-start):

curl -sSL https://raw.githubusercontent.com/Delaunay/freemace/master/install.sh | bash

This will:

• Create /opt/freemace/ with a Python venv and data directory

• Install uv if not already available

• Install the latest freemace package from PyPI

• Start a systemd user service on port 5002

After installation, open http://localhost:5002 in your browser.

Manual Install

pip install freemace

Then run the server:

freemace serve --port 5002

Configuration

After installing, you can configure git backup and auto-updates from the Settings page in the web UI, or via the CLI:

# Set up automatic git backup to GitHub
freemace setup-git [e-mail]:username/freemace-data.git

# Check for and install updates
freemace update --restart

# View or change configuration
freemace config
freemace config auto_update true

Useful Commands

sudo systemctl status freemace      # check service status
sudo systemctl restart freemace     # restart
sudo journalctl -u freemace -f      # view logs

Features

• Budget spreadsheet with income/expense tracking, categories, and pivot summaries

• CSV import/export

• Dark/light theme

• Automatic git backup to GitHub on every save

• SSH key generation and guided GitHub setup from the UI

• Auto-update from PyPI with service restart

• One-command installation with systemd service