Skip to content

Commit 1dccd25

Browse files
Revise README for clarity and project details
Updated the README to enhance project descriptions and structure.
1 parent a5b479d commit 1dccd25

File tree

1 file changed

+61
-51
lines changed

1 file changed

+61
-51
lines changed

README.md

Lines changed: 61 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -1,75 +1,81 @@
1+
<h1 align="center"> Python Beginner-Friendly Projects</h1>
12

2-
# 🐍 Python Beginner Friendly Project's
3+
<p align="center">
4+
A curated collection of <b>9 simple yet practical Python projects</b> — perfect for beginners learning loops, functions, logic, and file handling.
5+
</p>
36

4-
This repository contains **9 beginner-friendly Python projects**.
5-
They are small programs to practice Python basics like variables, loops, functions, file handling, and simple logic.
6-
7-
8-
---
9-
10-
## 📂 Projects Included
11-
12-
1. 🎓 [Student Grade Calculator](student-grade-calculator/)
13-
2.[Random Quote Generator](random-quote-generator/)
14-
3. ⚖️ [BMI Calculator](bmi-calculator/)
15-
4. 📒 [Simple Contact Book](simple-contact-book/)
16-
5. ⏱️ [Stopwatch / Timer](stopwatch-timer/)
17-
6.[Alarm Clock](alarm-clock/)
18-
7.[To-Do List](To-Do-list/)
19-
8. 🗂️ [File Organizer](file-organizer/)
20-
9. 🔢 [Unit Converter](unit-converter/)
7+
<p align="center">
8+
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.x-blue?style=for-the-badge&logo=python"></a>
9+
<a href="https://github.com/mantrapatil03/python-beginner-friendly-projects/stargazers"><img src="https://img.shields.io/github/stars/mantrapatil03/python-beginner-friendly-projects?style=for-the-badge&logo=github"></a>
10+
<img src="https://img.shields.io/badge/Level-Beginner-success?style=for-the-badge">
11+
<img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge">
12+
</p>
2113

2214
---
2315

24-
## 🚀 How to Run
25-
26-
1. Clone this repo:
27-
```bash
28-
git clone https://github.com/mantrapatil03/python-beginner-friendly-projects.git
16+
## Overview
2917

30-
2. Go into a project folder, for example:
31-
32-
cd student-grade-calculator
18+
This repository contains **9 beginner-friendly Python projects**,
19+
each crafted to help you **learn, practice, and apply** basic Python programming skills.
3320

21+
You'll find small but useful programs — great for understanding **core syntax, file I/O, loops, and logic building**.
3422

23+
---
3524

25+
## Projects Included
3626

27+
| No. | Project Name | Description |
28+
|-----|---------------|-------------|
29+
| 1️⃣ | 🎓 [Student Grade Calculator](student-grade-calculator/) | Calculate average grades and performance. |
30+
| 2️⃣ |[Random Quote Generator](random-quote-generator/) | Displays random motivational or funny quotes. |
31+
| 3️⃣ | ⚖️ [BMI Calculator](bmi-calculator/) | Computes Body Mass Index from height and weight. |
32+
| 4️⃣ | 📒 [Simple Contact Book](simple-contact-book/) | Store, search, and manage contacts easily. |
33+
| 5️⃣ | ⏱️ [Stopwatch / Timer](stopwatch-timer/) | Simple stopwatch and countdown timer. |
34+
| 6️⃣ |[Alarm Clock](alarm-clock/) | Set alarms using Python’s `datetime` and `time` modules. |
35+
| 7️⃣ |[To-Do List](To-Do-list/) | Manage daily tasks with add/remove features. |
36+
| 8️⃣ | 🗂️ [File Organizer](file-organizer/) | Automatically sort files into folders by extension. |
37+
| 9️⃣ | 🔢 [Unit Converter](unit-converter/) | Convert between common measurement units. |
3738

39+
---
3840

41+
## How to Run
3942

40-
3. Run the script:
43+
1️⃣ **Clone the repository**
44+
```bash
45+
git clone https://github.com/mantrapatil03/python-beginner-friendly-projects.git
46+
```
47+
2️⃣ Navigate to any project folder
48+
```
49+
cd student-grade-calculator
50+
```
4151

52+
3️⃣ Run the script
53+
```
4254
python main.py
55+
```
4356

57+
Some projects may use tkinter for GUI — make sure it’s installed (it usually comes preinstalled with Python).
4458

59+
## Tech Stack
4560

61+
- `Python 3.x`
4662

47-
---
48-
49-
## 🛠 Tech Used
50-
51-
Python 3.x
52-
53-
Standard libraries (random, time, os, etc.)
54-
55-
(Optional) tkinter for simple GUI apps
56-
57-
63+
- Standard Libraries (`os`, `time`, `random`, `math`, etc.)
5864

59-
---
65+
- (Optional) tkinter for GUI-based mini apps
6066

61-
## 🎯 Purpose
67+
## Purpose
6268

63-
This repo is made to:
69+
This repository is designed to help you:
6470

65-
Practice core Python concepts
71+
- Practice core Python programming concepts
6672

67-
Build small but useful programs
73+
- Strengthen logical thinking through small projects
6874

69-
Prepare for bigger intermediate & advanced projects
70-
---
75+
- Build confidence for intermediate and advanced projects
7176

72-
```text
77+
### ASCII Art Fun
78+
```
7379
____ _ _
7480
__|_|__|_|__ | _ \ _ _| |_| |__ ___ _ __
7581
| | | | | |_) | | | | __| '_ \ / _ \| '_ \
@@ -78,13 +84,17 @@ Prepare for bigger intermediate & advanced projects
7884
|___/
7985
```
8086

87+
## Author
8188

82-
## 👨‍💻 Author
83-
84-
Mantra Patil
89+
**Mantra Patil**
8590

8691
💼 LinkedIn: www.linkedin.com/in/mantrapatil25
8792

88-
93+
94+
95+
<h3 align="center">✨ Thanks for visiting my profile! ✨</h3> <p align="center"> If you like this project, consider giving it a ⭐ on GitHub! <br><br> <img src="https://img.shields.io/badge/Keep%20Coding-Learn%20by%20Doing-orange?style=for-the-badge&logo=python"> <img src="https://img.shields.io/badge/Open%20Source-Contributions%20Welcome-blue?style=for-the-badge&logo=github"> </p>
96+
97+
98+
99+
89100

90-
✨ Thanks for visiting my profile!

0 commit comments

Comments
 (0)