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/
| 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 |
git clone https://github.com/lokeshpuma/Python-mini-projects.git
cd Python-mini-projects
python projects/tic_tac_toe.pyGUI projects need Tkinter (digital_clock.py, slideshow.py, text_editor.py, tic_tac_toe.py).
- Push this repo to github.com/lokeshpuma/Python-mini-projects.
- In the repo: Settings → Pages → Build and deployment → Source: select GitHub Actions.
- Push to
main— the workflow uploadssrc/and publishes the site.
To preview locally:
cd src && python -m http.server 8080
# open http://localhost:8080| 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.