💰 Expense Tracker CLI (Python)

A simple and practical command-line expense tracker built using Python. This project helps users record, manage, and analyze daily expenses directly from the terminal.

---

🚀 Features

• ➕ Add daily expenses with category
• 📅 Automatic date tracking
• 💰 View total spending
• 🔍 Filter expenses by category
• 📋 View all recorded expenses
• 📊 Category-wise expense summary
• 💾 Persistent storage using JSON (data is saved locally)
• 🧾 Clean and readable JSON format

---

🛠️ Tech Stack

• Python
• Object-Oriented Programming (OOP)
• File Handling (JSON)
• CLI (Command Line Interface)

---

📂 Project Structure

expense-tracker-cli/
│
├── main.py            # CLI interface (user interaction)
├── tracker.py         # Core logic (ExpenseTracker class)
├── expenses.json      # Data storage
├── README.md          # Project documentation
├── requirements.txt   # Dependencies (none for now)

---

▶️ How to Run

1. Clone the repository:

git clone https://github.com/your-username/expense-tracker-cli.git

2. Navigate into the project folder:

cd expense-tracker-cli

3. Run the program:

python main.py

---

💡 Example Usage

===== Expense Tracker =====
1. Add Expense
2. View Total
3. Filter by Category
4. Show All Expenses
5. Category Summary
6. Exit

---

📸 Sample Data (JSON)

[
    {
        "amount": 200,
        "category": "Food",
        "date": "2026-03-29"
    },
    {
        "amount": 500,
        "category": "Travel",
        "date": "2026-03-29"
    }
]

---

🎯 Future Improvements

• 📅 Monthly expense analysis
• 📈 Data visualization (charts using matplotlib)
• 📤 Export data to CSV
• 🖥️ GUI version (Tkinter / Web app)
• 🔐 Authentication / multi-user support

---

👩‍💻 Author

Riya Patel

---

⭐ Notes

This project was built as a practical implementation of Python OOP concepts and CLI-based application design. It focuses on clean structure, usability, and real-world relevance.