Build useful things. Learn modern Python. From scripts to AI agents.
A project-based Python learning challenge. Instead of solving isolated exercises, each project builds something you can run, use, and extend.
This repository started in 2021 and reached 15 projects. In 2026, the challenge is being revived with a clearer learning path, modern Python practices, and optional AI upgrades.
16 / 100+ projects completed
| # | Project | Area | Key skills |
|---|---|---|---|
| 001 | 1 Minute Math | Basics | loops, functions, random, time |
| 002 | English / Chinese Translation | API | HTTP, translation API |
| 003 | Add Text Watermark on Pictures | Image | Pillow, image processing |
| 004 | Check Your English Speech | Audio | microphone, speech recognition |
| 005 | Check English Speech with Baidu ASR | Audio / API | ASR, cloud API |
| 006 | Arithmetic Formatter | Basics | strings, formatting, validation |
| 007 | OpenCV Capture Camera Video | Vision | OpenCV, camera |
| 008 | MediaPipe Hands Detection | Vision | OpenCV, MediaPipe |
| 009 | Count Fingers with MediaPipe | Vision | landmarks, gesture logic |
| 010 | Gobang | Game | game logic, GUI |
| 011 | Snake | Game | game loop, input |
| 012 | Minesweeper | Game | grid algorithms, state |
| 013 | Pose Game | Vision / Game | pose detection, MediaPipe |
| 014 | Tetris | Game | 2D grid, game loop |
| 015 | 2048 | Game | Turtle, 2D lists |
| 016 | Smart File Organizer | Files | pathlib, shutil, argparse, logging |
The goal is still 100+ projects, but the challenge is now organized into levels so you can follow a practical progression rather than a random list of demos.
| Level | Theme | Target |
|---|---|---|
| 1 | Python Basics | 15 projects |
| 2 | Useful Scripts | 15 projects |
| 3 | Files & Automation | 10 projects |
| 4 | Web & APIs | 15 projects |
| 5 | Data & Visualization | 10 projects |
| 6 | Images / Audio / Video | 10 projects |
| 7 | AI with Python | 15 projects |
| 8 | AI Agents / Real Apps | 10 projects |
See the proposed next projects in ROADMAP.md.
New and gradually refreshed projects may include three layers:
- Basic — solve the problem with simple, readable Python.
- Better — improve structure with modern Python practices such as
pathlib, type hints, tests, CLI arguments, logging, and packaging. - AI Upgrade — where it genuinely adds value, extend the same project with local or cloud AI.
The AI layer is optional. The project should still teach useful Python without it.
The original 001–015 project links are intentionally preserved so existing bookmarks and forks do not break. Future projects will use a more consistent per-project structure, and older projects can be modernized gradually rather than through a disruptive rewrite.
Typical new project structure:
projects/
└── 016-smart-file-organizer/
├── README.md
├── main.py
├── tests/
└── assets/
This repository is not meant to be a collection of 100 toy snippets.
The idea is simple:
- Build something small enough to finish.
- Learn a few Python concepts while building it.
- Make it actually runnable.
- Improve it when you learn better techniques.
- Gradually move from scripts to real applications and AI agents.
Learn Python by building things.
This project is licensed under the MIT License.
这是一个通过实际项目学习 Python 的挑战。
仓库从 2021 年开始，目前完成了 15 个项目。2026 年重新启动后，不再只是机械地从 016 一直做到 100，而是按学习阶段组织项目，并逐步加入现代 Python 工程实践以及可选的 AI Upgrade。
目标没有改变：做 100+ 个真正可以运行、可以继续改进的小项目。
接下来的 016–030 计划见 ROADMAP.md。
本项目基于 MIT License 开源。