Table of Contents generated with DocToc

• Money Manager
  • 👥 Functionality
  • 👨‍💻 Developer Friendly
  • 🛠️ Installation and Dev
  • 👨‍💻 Screenshots of Functionalities
  • 🤝 Contributing
  • 📜 Code of Conduct
  • 🔦 Support

Money Manager

A REST API application for managing expenses. Build your own automation—be it a Telegram bot 🤖, Discord bot, or your own app 📱! Now includes WebAPI and a telegram bot.

📽️ Introducing Money Manager

• Introduction animation
• New features in V3

✅ Quality

Code coverage graph:

📊 Stats

🛠️ Tools & Technologies

👥 Functionality

• Expense Tracking: Add, update, and delete expenses. Track expenses by category, date, and account.
• Authentication: Secure access to your data using token-based authentication.
• RESTful API: Access and interact with your financial data programmatically via a FastAPI-powered API.
• Data Visualization: View your expenses over time with customizable charts, including:
  • Monthly and weekly spending trends
  • Categorical expense breakdowns
• Multiple Accounts: Manage multiple accounts like spending and saving.

👨‍💻 Developer Friendly

• Modular Configuration: Simplify setup with a sample_config.py file that supports environment variables for secure, customizable settings like database URIs, API ports, and bot tokens—just rename and update, or export values directly from your environment!
• Stable Release(master) Branch: We have Pre-commit running as github workflows which allows only the tested, formatted, linted, checked, code to push to the release branches
• Comprehensive Test Suite: With over 150 testcases in unit test suite, developer can easily extend and follow Test Driven Development.
• >95% Code coverage: Well, almost all the lines of the code is covered in the unit test suite. Extend without worrying about what'll break the current functionality.
• Testing Suite: Comprehensive tests to ensure stability and reliability across key functionality.

🛠️ Installation and Dev

Refer to INSTALL for the guidance and follow the steps.

👨‍💻 Screenshots of Functionalities

| What | Screenshot | What | Screenshot | What | Screenshot | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | Sign Up |
| Login |
| Add Expenses |
| | Different Currency |
| Multiple Accounts |
| View Expenses |
| | Update Expenses |
| Delete Expenses |
| Delete All Expenses |
| | Add Categories |
| View Categories |
| Update Categories |
| | Delete Categories |
| Add Accounts |
| View Accounts |
| | Update Accounts |
| Delete Accounts |
| Analytics |
| | Export Range |
| Export Format |
|Group Level Commands |
| | Issue Group Bill Split |
| Group Level transaction Status |
| Group Transfer |
| | Cancel Group Level Transaction |
| Budget Alert |
| Transfer Between Accounts |
|

🔮 Future Features

• Transaction Roll Back: Allow users to roll back transactions incase of misinputs.
• Shared Group Account: Allow users in a group to create a shared bank account and keep track of group funds.
• Recurring Expenses: Allow users to set up recurring expenses.
• Expense Remdiners: Will notify users of upcoming payments and deadlines.
• Reports: Generate customized reports about spending habits.
• AI-driven Insights: Use AI to analyze spending reports and generate personalized tips.

🤝 Contributing

Thank you for your interest in contributing to MoneyManager! Your contributions are greatly appreciated, and this guide will help you get started. For full details on contributing, please refer to the CONTRIBUTING.md file, which provides comprehensive instructions and guidelines.

📜 Code of Conduct

Please note that we have a Code of Conduct that all contributors are expected to uphold. This ensures that our community remains welcoming and inclusive for everyone.

🔦 Support

If you have any questions or need assistance, please feel free to reach out. You can contact us via email at mmv3 @ 550w . host (remove spaces) or through our GitHub Discussions.