Python Mini Projects

A collection of beginner-to-intermediate Python mini projects — games, utilities, calculators, and automation scripts for learning and portfolio building.

Live site: https://lokeshpuma.github.io/Python-mini-projects/

---

Repository layout

Path	Purpose
src/	Static web app deployed to GitHub Pages
projects/	Python source files (run locally)
.github/workflows/deploy-pages.yml	Auto-deploy src/ on push to main

---

Run Python projects locally

git clone https://github.com/lokeshpuma/Python-mini-projects.git
cd Python-mini-projects
python projects/tic_tac_toe.py

GUI projects need Tkinter (digital_clock.py, slideshow.py, text_editor.py, tic_tac_toe.py).

---

GitHub Pages deployment

1. Push this repo to github.com/lokeshpuma/Python-mini-projects.
2. In the repo: Settings → Pages → Build and deployment → Source: select GitHub Actions.
3. Push to main — the workflow uploads src/ and publishes the site.

To preview locally:

cd src && python -m http.server 8080
# open http://localhost:8080

---

Projects

Project	Description
Contact Book	Store, search, update, and delete contacts
Digital Clock	Real-time digital clock (Tkinter)
Rent Calculator	Split bills among roommates
Rock Paper Scissors	Classic game vs computer
Slideshow	Image slideshow
Spell Checker	Basic spelling tool
Student Grade System	Manage student grades
Payment Simulation	Simple payment workflow
Task Manager	Add and track tasks
Text Editor	Lightweight editor
Tic Tac Toe	Two-player game (Tkinter)

Browser demos for Rock Paper Scissors, Tic Tac Toe, Rent Calculator, and Student Grade are on the live site.