freemace

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 git@github.com: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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

freemace-0.9.0.tar.gz (224.5 kB view details)

Uploaded Apr 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

freemace-0.9.0-py3-none-any.whl (224.0 kB view details)

Uploaded Apr 23, 2026 Python 3

File details

Details for the file freemace-0.9.0.tar.gz.

File metadata

Download URL: freemace-0.9.0.tar.gz
Upload date: Apr 23, 2026
Size: 224.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for freemace-0.9.0.tar.gz
Algorithm	Hash digest
SHA256	`3cc68a4125d61ef71d21ec1491b1847ae54e8b48b2473f8df53ca2dd3a68ef3c`
MD5	`7fe30a3376ab0d8373971eb0a5e609f0`
BLAKE2b-256	`dcee9ab0b36f5c0cfb69e05d83b048de8c2891f8c9b79c2dd7ea171e6f4ac8c0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for freemace-0.9.0.tar.gz:

Publisher: publish.yml on Delaunay/freemace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: freemace-0.9.0.tar.gz
- Subject digest: 3cc68a4125d61ef71d21ec1491b1847ae54e8b48b2473f8df53ca2dd3a68ef3c
- Sigstore transparency entry: 1361139905
- Sigstore integration time: Apr 23, 2026
Source repository:
- Permalink: Delaunay/freemace@db550dc29cdf78533f9a2be99c06677ede305f5e
- Branch / Tag: refs/tags/v0.9.0
- Owner: https://github.com/Delaunay
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@db550dc29cdf78533f9a2be99c06677ede305f5e
- Trigger Event: push