Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/muhammadalamzeb/python_projects/llms.txt

Use this file to discover all available pages before exploring further.

Python Projects is a curated set of beginner-friendly command-line applications written in pure Python. Each project is self-contained in a single file — no dependencies to install, no setup required beyond Python itself. Whether you want to play a number guessing game, roll some dice, or practice ordering from a virtual restaurant, every project is ready to run in seconds.

Introduction

Learn what each project does and how this collection is organized.

Quickstart

Get Python installed and run your first project in under two minutes.

All Projects

Browse all five projects with full usage instructions and code walkthroughs.

Running Scripts

Learn how to run any Python script from your terminal on any platform.

What’s included

Calculator with History

A four-operation calculator that saves every calculation to a file so you can review or clear your history anytime.

Number Guessing Game

Guess a secret number between 1 and 100. The game gives you “too high” or “too low” hints until you crack it.

Dice Game

Roll two virtual dice and see the result instantly. Keep rolling as many times as you like.

Fake Headline Generator

Generate absurd breaking-news headlines by randomly combining subjects, actions, and locations.

Restaurant Management System

Browse a menu, add items to your order, and watch your total grow — an interactive ordering experience in the terminal.

Get started

1

Check your Python version

Open a terminal and run python3 --version. You need Python 3.6 or higher.
2

Clone the repository

git clone https://github.com/muhammadalamzeb/python_projects.git
cd python_projects
3

Run a project

python3 Calculator_With_History.py
Replace the filename with any project you want to try.
No virtual environment or pip install needed — every project uses only Python’s standard library.

Build docs developers (and LLMs) love