An AI powered Expense Tracker built to designed to track, categorize, and optimize expenses while providing financial insights and budget forecasting to enhance financial well-being.

This README fully documents the project with clear structure, features, and setup instructions.

This is a personal expense tracker web application built using Django. It allows users to log their expenses, categorize them, and provides automated expense categorization and future expense prediction features. This README.md file provides instructions for setting up and running the application on your local machine, as well as some additional information about its features and usage.

• Expense Logging: Easily log your daily expenses, including the date, description, amount, and category.

• Automated Expense Categorization: The application uses machine learning algorithms to automatically categorize expenses based on their descriptions. This makes it easier to track and manage your spending.

• Future Expense Prediction: The application provides predictions for future expenses based on your spending history. This can help you plan your budget more effectively.

• OCR & NLP Integration – Extracts and categorizes expense data from receipts using advanced OCR (Tesseract) and NLP techniques.

• Smart Budgeting & Real-Time Alerts – Provides personalized budgeting recommendations and notifies users of potential overspending.

• Interactive Financial Dashboard – Visualizes spending patterns, income trends, and budget insights through AI-driven analytics.

1. Create a new account or log in using your superuser account.

2. Start logging your expenses by clicking the "Add Expense" button.

3. Fill in the expense details, including the date, description, amount, and category. You can also leave the category empty, and the application will attempt to automatically categorize it.

4. View your expense history, categorized expenses, and future expense predictions on the dashboard.

5. To access the admin panel, go to http://localhost:8000/admin/ and log in with your superuser credentials. From the admin panel, you can manage users, categories, and view the database.

├── dev.axi.expensetracker
│   ├── axi
│   │   ├── LICENSE
│   │   ├── api/                   # API-related files (models, views, serializers, etc.)
│   │   ├── authentication/        # User authentication logic
│   │   ├── expense_forecast/      # Expense forecasting functionality
│   │   ├── expenses/              # Expense tracking logic
│   │   ├── goals/                 # User financial goals management
│   │   ├── report_generation/     # Automated report generation
│   │   ├── expensetracker/        # Core Django project files (settings, URLs, etc.)
│   │   ├── static/                # Frontend assets (CSS, JS, images)
│   │   ├── staticfiles/           # Collected static files for deployment
│   │   ├── db.sqlite3             # SQLite database (for local development)
│   │   ├── manage.py              # Django management script
│   │   ├── requirements.txt       # Dependencies list
│   │   ├── nltk_downloader.py     # Script for downloading NLP-related datasets
│   │   ├── mydatabase/            # Placeholder for database-related scripts/files
│   │   ├── dataset.csv            # Sample dataset for analysis
│   │   ├── currencies.json        # JSON file with currency data
├── README.md

• HTML, CSS for UI
• JavaScript for interactivity
• Fetch API for backend communication

• Django for backend development
• Django REST Framework (DRF) for API
• PostgreSQL for database management

• TensorFlow/PyTorch for AI-driven recommendations
• Tesseract OCR / Google Vision API for receipt scanning

• Docker for containerization
• Gitpages for cloud deployment

• Bank Account Sync – Integrate Plaid/Open Banking APIs.
• Fraud Detection – AI-powered alerts for suspicious transactions.
• Voice Commands – Track expenses via voice-enabled AI assistant.
• Blockchain Integration – Secure, decentralized financial data tracking.

We welcome open-source contributions! 🎉

🔹 Fork this repo and create a branch
🔹 Follow best coding practices (PEP-8 for Python, ESLint for JS)
🔹 Submit a Pull Request (PR) for review

happycoding! 🚀😊

Developers & Contributors( Made with love ❤️ ) by Ashriel, Danielle Ananga