Skip to content

tuttle-dev/tuttle

Repository files navigation


Tuttle

License Commit Activity

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.

Note: Tuttle is currently in development. The current version is a prototype, not quite ready for production use. However, we are happy to receive feedback from testers.

Mission Statement

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 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.

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 desktop application. 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. We are consciously developing a desktop app with local data storage, not a web app, since your business data is none of our business.

Features

Business Data Management

Manage your business contacts and contract terms for your project - all in one place.

Time Tracking

Track the time you spend on your projects. Import from your cloud calendar or from your favorite time tracking tool.

Invoicing

Generate invoices and timesheets automatically from your time tracking data. Export to PDF and send via email.

Roadmap

Income Forecasting

Project your income for the next months based on your project planning. See how changes in your schedule affect your bottom line.

Expense Tracking & Forecasting

Track regular expenses, taxes and social security contributions. Estimate them for the future based on expected revenue.

Safe to Spend

Calculate your effective income and see how much you can spend without risking your financial security.

Test via Python

Setup

  1. Clone or download the current version.

  2. We recommend installation into a new virtual environment.

  3. Install the Python module in development mode:

pip install -e .
  1. To verify, run the unit tests:
$ pytest
  1. Start the app with
$ python app/app.py

Test the App Bundle

Download the latest release for your platform.

macOS

  1. Run the .app bundle.

Linux

  1. Run the executable.

Windows

  1. Requires GTK.
  2. Run the .exe file.

Build

To build an app bundle, run

python scripts/pack_app.py

Contributing

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

Code style: black

Acknowledgements

This project has received funding by the Prototype Fund in 2022.