🪰 Tuttle - time and money management for freelancers

View the Project on GitHub tuttle-dev/tuttle


[![License](https://img.shields.io/github/license/tuttle-dev/tuttle?color=green&style=flat-square)](https://github.com/tuttle-dev/tuttle/blob/main/LICENSE) [![Commit Activity](https://img.shields.io/github/commit-activity/m/tuttle-dev/tuttle?style=flat-square)]()

Time and money management for freelancers

HARRY TUTTLE: Bloody paperwork. Huh!
SAM LOWRY: I suppose one has to expect a certain amount.
HARRY TUTTLE: Why? I came into this game for the action, the excitement. Go anywhere, travel light, get in, get out, wherever there's trouble, a man alone.

Tuttle is an open-source software project supported by the Prototype Fund. We are developing a time and finance planning tool tailored for the requirements of freelancers.

Which challenges does the project address?

The working world is changing, the trend is towards freelancing: software developers, designers and journalists appreciate the freedom and creative possibilities of solo self-employment. More and more professionals are choosing it for themselves. It allows them to specialize and gain experience with many projects and clients.

With freelancing, there are many side activities: Marketing, client communication, legal and financial planning - although the latter probably appeals to few solo self-employed people. But neglected financial planning carries the risk of insolvency, debt, precarious self-employment, or poverty in old age. This also creates burdens for the social systems.

But what if software could make financial planning in freelancing almost as easy as being an employee? Our tool minimizes risks and makes the financial part of the job easy. Freelancing becomes more efficient, less risky, and therefore more beginner-friendly.

How are you tackling the problem?

With Tuttle, we are developing a financial planning tool that is tailored to the needs of solo freelancers. We automate and give freelancers more time to do the work they love. The application provides analysis and forecasting functions on income, expenses, disposable income, uncertainty management or explainability of the forecast and convinces with portability, among other things.

We develop the solution as a GUI application based on web technologies. Sensitive financial data is processed locally on the end device without central data collection. For data analysis, we rely on open source tools from the Python ecosystem.

What is the product vision?

Desktop apps are great - let’s have more of them. We are consciously developing a desktop app with local data storage, not a web app, since your business data is none of our business.

Prototype Test

Demo Notebooks

A demo of the core functionality is available as a series of Jupyter notebooks at notebooks/walkthrough/. If you have basic Python programming skills you will be able to test this. We appreciate your feedback.

Demo App

A desktop app is under development. Currently, the app includes some demo functionality.


  1. Clone or download the current version from the main branch.

  2. We recommend installation into a new virtual environment.

  3. Install the Python module in development mode:

$ python setup.py develop
  1. To verify, run the unit tests:
$ pytest
  1. Start the demo app with
$ python app/Tuttle.py


  1. Open and run the demo notebooks with Jupyter Lab.
$ jupyter lab


Your contributions are welcome. Please follow the guide (CONTRIBUTING.md).

Code style: black


This project has received funding by the Prototype Fund.