MCPcopy Index your code
hub / github.com/Mrinank-Bhowmick/python-beginner-projects

github.com/Mrinank-Bhowmick/python-beginner-projects @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
1,752 symbols 5,226 edges 509 files 380 documented · 22%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

pyBegin — Python Beginner Projects

270+ bite-sized Python projects to learn by building — each one a weekend's worth of fun.

Live site Stars Forks License PRs welcome


🚀 Try it live — no install needed

pybegin.pages.dev is a searchable gallery of every project in this repo — and 60+ of them run right in your browser.

The playground runs real CPython in the browser via Pyodide: a live code editor, an interactive console for input(), and an annotated, beginner-friendly walkthrough of each project. Pick one, hit ▶ Run code, and start tinkering — nothing to install.

Browse all projects → pybegin.pages.dev

✨ Why this repo

  • 270+ projects — from one-liners to small apps: games, tools, scrapers, GUIs, ML notebooks, and more.
  • Beginner-first. Every project is small, self-contained, and an ideal first pull request.
  • Learn by reading and running. The in-browser playground lets you read real code and change it instantly.
  • A genuine open-source on-ramp. Hundreds of people made their first contribution here.

🏃 Run a project locally

git clone https://github.com/Mrinank-Bhowmick/python-beginner-projects.git
cd python-beginner-projects/projects/<project-name>
pip install -r requirements.txt   # only if the project ships one
python main.py

Every project lives in its own folder under projects/, each with a README.md explaining what it does and how to run it.

🤝 Contributing

New projects and improvements are very welcome — this is a friendly place for your first open-source contribution.

  1. Read CONTRIBUTING.md and the CODE_OF_CONDUCT.md.
  2. Add your project as a new folder in projects/ with its own README.md.
  3. Open a pull request.

⭐ Stargazers over time

Stargazers over time

Contributors

Mrinank-Bhowmick Mrinank Bhowmick lint-action Lint Action ibra-kdbra Ibra-kdbra Alby084 Alby084 itsyashvardhan Yashvardhan Singh ca20110820 Cedric Anover
kanchanraiii Kanchan Rai TERNION-1121 Vikrant Singh Bhadouriya Guyunjeong Chloe rik-chatterjee Rik Chatterjee yanliutafewa Yanliutafewa Tark-pea Tark-pea
omkarxpatel Omkar Patel UffaModey Fafa Modey anish2105 Anish Vantagodi JohnRTitor Masum Reza sudipg4112001 Sudip Ghosh tylerapear Tyler Pearson
justinjohnson-dev Justin Johnson Gabriela20103967 Gabriela20103967 shashaaankkkkk Shashank Shekhar bim22614 Bim22614 ng-lis Ng-lis jrbublitz Jefferson Bublitz
shriyansnaik Shriyans Naik vagxrth Vagarth Pandey xlo-u Yash Upadhyay payallenka Payallenka DevTomilola-OS Oluwatomilola herepete Peter White
nayan2306 Nayan Chandak ZackeryRSmith Zackery .R. Smith SirRomey SirRomey KartikRN Kartik Nandagaon snehafarkya Sneha Farkya SyedShagufta Syed Shagufta Noval
odhyp Odhy bibaswanroy Bibaswan Roy SuhasBk Suhas Kowligi MonitSharma Monit Shar

Extension points exported contracts — how you extend this code

Project (Interface)
(no doc)
web/src/types.ts
Category (Interface)
(no doc)
web/src/types.ts
CatalogProject (Interface)
(no doc)
web/src/types.ts
Contributor (Interface)
(no doc)
web/src/types.ts
RepoContributor (Interface)
(no doc)
web/src/types.ts

Core symbols most depended-on inside this repo

execute
called by 62
projects/Space Shooter/main.py
title
called by 52
projects/Skycast/skycast.py
update
called by 43
projects/PONG/main.py
compCOMPLETER
called by 37
projects/Tic-Tac-Toe/TicTacToe-GUI/oneplayermode.py
compCOMPLETER
called by 33
projects/Tic-Tac-Toe/TicTacToe-GUI/tic tac.py
search
called by 26
projects/Qt5_YouTube/main.py
exit
called by 23
projects/Tkinter/2.py
get_all_items
called by 21
projects/Expense-Tracker/item.py

Shape

Function 866
Method 650
Class 182
Route 40
Interface 14

Languages

Python96%
TypeScript4%

Modules by API surface

projects/Space Shooter/main.py48 symbols
projects/Expense-Tracker/item.py37 symbols
projects/PONG/main.py35 symbols
projects/Battleship/battleship_v2/test_battleship.py31 symbols
projects/Expense-Tracker/test_expense_tracker.py27 symbols
projects/Snake Game/tests/test_game.py24 symbols
projects/Chess/main.py23 symbols
projects/Text Editor/Text-Editor-master/Text_Editor.py21 symbols
projects/Snake Game/tests/test_display.py20 symbols
projects/Battleship/battleship_v2/board.py20 symbols
projects/Battleship/battleship_v2/game.py18 symbols
projects/Tic-Tac-Toe/TicTacToe-GUI/tic tac.py17 symbols

Datastores touched

(mongodb)Database · 1 repos

For agents

$ claude mcp add python-beginner-projects \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact