[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0) [![Contributors](https://img.shields.io/github/contributors/TreyWW/MyFinances)](https://github.com/TreyWW/MyFinances/graphs/contributors) [![Stars](https://img.shields.io/github/stars/TreyWW/MyFinances)](https://github.com/TreyWW/MyFinances/stargazers) **MyFinances** is an open-source invoicing and financial management platform designed for freelancers, small businesses, and teams. Create professional invoices, automate reminders, and stay organized. [📚 **Documentation**](https://strelix.link/myfinances-docs) • [🚀 **Get Started**](#getting-started) • [🤝 **Contributing**](#contributing) | PLEASE NOTE: This project is under active development and not production ready. We welcome contributors! | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

Key Features

Feature	Description
📄 Professional Invoices	Create and send stunning one-time invoices
🔄 Recurring Invoices	Automate periodic billing with scheduled invoices
⏰ Smart Reminders	Never miss a payment with automated email reminders
📧 Email Integration	Send invoices and reminders directly from the platform
👥 Team Collaboration	Manage finances collaboratively with team features

Getting Started

Prerequisites

Python 3.10+
Additional dependencies listed in pyproject.toml
Optional: Docker for containerized deployment
Optional: AWS services (EventBridge/SES/S3) for advanced features

Installation

For detailed setup instructions please refer to our documentation: https://strelix.link/myfinances-docs/

Contributing

We love contributions! Whether you're fixing bugs, adding features, or improving documentation, your help is welcome. Take a look at the contributing docs for more info.

Quick Contributing Guide

Fork this repository
Create a new branch for your changes
Make your changes following our coding standards
Test your changes (python manage.py test)
Submit a pull request

Security Vulnerabilities

Found a security vulnerability? Please don't open a public issue. Instead, email us directly at the address listed in our security policy.

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for more details

Contributors

A huge thank you to all our amazing contributors! 🎉

Star History

[![Star History Chart](https://api.star-history.com/svg?repos=TreyWW/MyFinances&type=Date)](https://star-history.com/#TreyWW/MyFinances&Date)