Skip to content

README.md

Latest commit

 

History

History
188 lines (131 loc) · 6.32 KB

README.md

File metadata and controls

188 lines (131 loc) · 6.32 KB
Raw
Python Learn App

Python 💻

Interactive Python Learning Platform for Beginners

React TypeScript Vite Capacitor Pyodide License Stars Issues Downloads

Learn Python from zero to hero — right from your phone.

No server. No ads. No account needed. Just you, your device, and Python.

Download APK • Run in Browser • Features • Source Code • Contributing

Download

Android APK

⬇ Download Python-learn-app.apk (5.6 MB)

Enable "Install from unknown sources" in your Android settings if prompted.

Run in Browser (No Install Needed)

# Clone the repo
git clone https://github.com/Tauseef666-ctrl/python-learn-app.git

# Navigate to the app folder
cd python-learn-app/python-learn-app

# Install dependencies
npm install

# Start the dev server
npm run dev

Open http://localhost:5173 in your browser — the full app runs in-browser via Pyodide (WebAssembly).

About

Python 💻 is a complete interactive Python learning platform designed for absolute beginners. It runs 100% offline with real Python code execution powered by Pyodide (WebAssembly) — no server, no internet required after first load.

Why Python 💻?

Feature Details
23 Chapters From print("Hello") to OOP and data structures
Real Code Execution Run Python directly in the app via Pyodide
Gamified Learning XP, levels, streaks, badges, and achievements
Boss Level Arena Build your own game in 10 guided levels
Fully Offline Works without internet after first load
No Ads / No Login Your progress, your data, your device
Dark Hacker UI Glassmorphism, matrix rain, terminal effects
Android + Browser APK for mobile, or run in any browser

Features

Learning System

  • Structured Lessons — theory, examples, challenges, quizzes per chapter
  • Interactive Code Editor — syntax-highlighted editor with real-time execution
  • Auto-Grading — your code is tested against expected outputs automatically
  • Adaptive Difficulty — adjusts based on your performance

Gamification

  • XP & Leveling — earn XP for every completed challenge
  • Daily Streaks — track your consistency
  • Badges & Trophies — unlock achievements as you progress
  • Boss Level — 10-level capstone where you build a complete game

Unique Features

  • Skill Tree Map — visual network graph of your learning path
  • The Oracle — offline rubber-duck mentor
  • White-Hat Track — cybersecurity-themed Python challenges
  • Code Golf Mode — compare your solution to the shortest known
  • Unlockable Terminal Skins — earn new color themes with XP
  • Konami Code Easter Egg — hidden bonus chapter
  • Completion Certificates — downloadable PDF certificates
  • Export Your Game — save your Boss Level project as a .py file

Practice Modes

  • Practice Arena • Daily Challenge • Code Riddles • Debug the Hacker • Predict the Output • Speed Type

Screenshots

Splash Home Code Editor
Terminal boot animation Dashboard with XP & chapters Run Python in-app

Tech Stack

Technology Purpose
React 19 UI framework
TypeScript 5.7 Type-safe code
Vite 6 Fast build tool
Capacitor 7 Android APK packaging
Pyodide 0.26 Python in browser (WebAssembly)
Zustand 5 State management
Framer Motion 12 Smooth animations
CodeMirror 6 Code editor
IndexedDB Local data storage

Source Code

The full source code is in the python-learn-app/ folder.

python-learn-app/
├── src/
│   ├── components/     # 12 reusable UI components
│   ├── screens/        # 9 app screens
│   ├── data/           # Chapter content & themes
│   ├── store/          # Zustand state management
│   └── utils/          # Pyodide, DB, certificates
├── package.json
└── README.md           # Detailed source code docs

See the source code README for detailed architecture docs.

Contributing

Contributions welcome! See CONTRIBUTING.md for the full guide.

Quick start:

# Fork the repo on GitHub, then:
git clone https://github.com/YOUR_USERNAME/python-learn-app.git
cd python-learn-app/python-learn-app
npm install
npm run dev

# Make changes, then:
git add .
git commit -m "Your feature"
git push origin main
# Open a Pull Request on GitHub

License

This project is licensed under the MIT License — see LICENSE for details.

Built with Python 💻 — because everyone deserves to learn to code.

If this helped you, consider giving it a ⭐