A professional collection of GUI and CLI-based Python applications, refactored for portability, modularity, and modern aesthetics. This repository demonstrates clean architecture, robust file handling, and modern UI development using CustomTkinter.

• 📅 Precision Age Calculator - Real-time age calculation in years, months, days, and seconds using a modern dark-mode UI.
• ⏰ Elegant Digital Clock - A clean, persistent desktop clock widget with time validation.
• 🎓 Student Management System - A robust CLI database system for managing student and instructor records with file persistence.
• 🖼️ Modern Assets - Integrated PNG icon support using Pillow for cross-platform compatibility.
• 🚀 Modular Architecture - Clean separation of concerns with dedicated src, assets, and data directories.
• 🔧 Cross-Platform - portable file paths and universal dependency management.

Python/
├── 📄 README.md                    # Project documentation
├── 📄 .gitignore                   # Git ignore patterns
├── 📄 LICENSE                      # License details
│
├── 📂 age_calculator/              # 📅 Age Calculator App
│   ├── 📄 README.md                # Component documentation
│   ├── 📄 requirements.txt         # Component dependencies
│   ├── 📂 src/
│   │   └── main.py                 # Application entry point
│   └── 📂 assets/
│       └── icon.png                # App icon
│
├── 📂 clock/                       # ⏰ Digital Clock App
│   ├── 📄 README.md
│   ├── 📄 requirements.txt
│   ├── 📂 src/
│   │   └── main.py
│   └── 📂 assets/
│       └── icon.png
│
└── 📂 student_instructor/          # 🎓 Management System
    ├── 📄 README.md
    ├── 📄 requirements.txt
    ├── 📂 src/
    │   └── main.py
    └── 📂 data/                    # Data persistence layer
        ├── instructor.txt
        └── studentpy.txt

• Python 3.11 or higher
• pip (Python package manager)

1. Clone the repository

   git clone https://github.com/3bsalam-1/Python-Mini-Projects.git
   cd Python

2. Create a virtual environment (recommended)

   python -m venv venv
   
   # On Windows
   venv\Scripts\activate
   
   # On macOS/Linux
   source venv/bin/activate

3. Install dependencies Install all dependencies for GUI components:

   pip install customtkinter tkcalendar pillow

Launch the modern GUI to calculate age precision.

python age_calculator/src/main.py

Start the desktop clock widget.

python clock/src/main.py

Run the CLI management tool for database operations.

python student_instructor/src/main.py

Example CLI Interaction:

--- Main Menu ---
1: Instructor Management
2: Student Management
3: Exit
Your choice: 2

Issue: ModuleNotFoundError: No module named 'customtkinter'

• Solution: Run pip install customtkinter or pip install -r age_calculator/requirements.txt

Issue: _tkinter.TclError: couldn't recognize data in image file

• Solution: Ensure pillow is installed: pip install pillow. The project uses Pillow to handle PNG icons.

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/AmazingFeature
3. Commit your changes: git commit -m 'Add some AmazingFeature'
4. Push to the branch: git push origin feature/AmazingFeature
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

Ahmed Abdulsalam

• GitHub: @3bsalam-1
• LinkedIn: Ahmed Abdulsalam