Finance Tracker is a personal finance application built with Django and integrated with the Plaid API to help you manage your expenses, connect your bank accounts, and visualize your financial data through graphs.
- Connect bank accounts using Plaid API
- Track expenses and income
- Visualize financial data with interactive graphs
- Simple and intuitive user interface
- Python 3.x
- Django
- Plaid API credentials
- Git
-
Clone the Repository
git clone https://github.com/PixelFiestaStudios/finance_tracker.git cd finance_tracker
-
Create and Activate a Virtual Environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- Install Dependencies
pip install -r requirements.txt
Set Up Plaid API Credentials
- Add your Plaid API credentials to the settings.py file:
PLAID_CLIENT_ID = 'your_client_id'
PLAID_SECRET = 'your_secret'
PLAID_ENVIRONMENT = 'sandbox' # or 'development' or 'production'
- Run Migrations
python manage.py makemigrations
python manage.py migrate
- Run the Development Server
python manage.py runserver
- Access the Application
Open your web browser and navigate to https://127.0.0.1:8000.
Usage
- Connect Bank Account
• On the home page, enter your Plaid public token to connect your bank account.
- View Transactions
•View your transactions fetched from your connected bank account.
- Visualize Data
•Visit the graph page to see a visual representation of your financial data.
Contributing
We welcome contributions! Follow these steps to contribute:
- Fork the repository
- Create a new branch (git checkout -b feature-branch)
- Make your changes
- Commit your changes (git commit -m 'Add some feature')
- Push to the branch (git push origin feature-branch)
- Open a pull request
License This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments Plaid for their API and documentation Django for the web framework Matplotlib for data visualization sql Copy code
-
Create a README.md File
In the root of your project directory, create a file named
README.md
and paste the above content into it. -
Commit the README.md File
git add README.md git commit -m "Add README file"