██████╗ ██████╗ ███████╗ █████╗ ███╗ ███╗███████╗██╗ ██████╗ ██████╗ ██████╗ ███████╗
██╔════╝██╔═══██╗██╔════╝██╔══██╗████╗ ████║██╔════╝██║ ██╔════╝██╔═══██╗██╔══██╗██╔════╝
██║ ██║ ██║█████╗ ███████║██╔████╔██║█████╗ ██║ ██║ ██║ ██║██║ ██║█████╗
██║ ██║ ██║██╔══╝ ██╔══██║██║╚██╔╝██║██╔══╝ ██║ ██║ ██║ ██║██║ ██║██╔══╝
╚██████╗╚██████╔╝███████╗██║ ██║██║ ╚═╝ ██║███████╗███████╗╚██████╗╚██████╔╝██████╔╝███████╗
╚═════╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝
██████╗ ██╗ ██╗ █████╗ ██████╗ ██████╗ ██╗
██╔══██╗██║ ██║██╔══██╗██╔══██╗██╔══██╗██║
██████╔╝██║ ██║███████║██████╔╝██████╔╝██║
██╔═══╝ ██║ ██║██╔══██║██╔══██╗██╔══██╗██║
██║ ╚██████╔╝██║ ██║██████╔╝██████╔╝███████╗
╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═════╝ ╚═════╝ ╚══════╝
Master Python Data Structures & Algorithms Through Guided Experimentation
Features • Quick Start • Learning Path • Structure • Contributing • License
|
Structured progression from Python basics to advanced algorithms. Each phase builds on the previous, ensuring solid foundations before moving to complex topics. |
Master 15+ coding patterns (Sliding Window, Two Pointers, Fast & Slow, etc.) that solve 80% of LeetCode problems. |
|
Gamified learning with XP points, streaks, achievements, and visual progress indicators. Track your journey from beginner to expert. |
Watch algorithms come to life with Manim-powered visualizations. Perfect for understanding complex concepts. |
|
Structured challenges organized by difficulty with hints, solutions, and optimal approaches for 300+ problems. |
Start coding in seconds with GitHub Codespaces. Fully configured dev environment with all tools pre-installed. |
Click the button above to launch a fully configured development environment in your browser. No installation required!
# Clone the repository
git clone https://github.com/Harery/OCTALUM-PYLAB.git
cd OCTALUM-PYLAB
# Install uv (fast Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create virtual environment and install dependencies
uv sync --all-extras
# Install pre-commit hooks
uv run pre-commit install --install-hooks
# Run the learning tracker
uv run python -m pylab.track
# Start coding!
uv run python build/foundations/01-python-basics/hello.py# Run tests
uv run pytest verify/tests -v
# Run linter
uv run ruff check .
# Run type checker
uv run pyright build/╔══════════════════════════════════════════════════════════════════════════════╗
║ OCTALUM-PYLAB 8-PHASE JOURNEY ║
╠══════════════════════════════════════════════════════════════════════════════╣
║ ║
║ Phase 1: FOUNDATIONS Phase 5: PATTERNS ║
║ ├── Python Basics ├── Sliding Window ║
║ ├── Control Flow ├── Two Pointers ║
║ └── Functions ├── Fast & Slow Pointers ║
║ ↓ ├── Merge Intervals ║
║ └── Cyclic Sort ║
║ Phase 2: DATA STRUCTURES ↓ ║
║ ├── Arrays & Lists ║
║ ├── Strings Phase 6: ALGORITHMS ║
║ ├── Hash Tables ├── Searching ║
║ ├── Linked Lists ├── Sorting ║
║ ├── Stacks & Queues ├── Recursion ║
║ ├── Trees └── Dynamic Programming ║
║ └── Graphs ↓ ║
║ ↓ ║
║ Phase 7: CHALLENGES ║
║ Phase 3: ALGORITHMS ├── LeetCode Easy ║
║ ├── Searching ├── LeetCode Medium ║
║ ├── Sorting ├── LeetCode Hard ║
║ └── Recursion └── System Design ║
║ ↓ ↓ ║
║ ║
║ Phase 4: ADVANCED DS Phase 8: MASTERY ║
║ ├── Heaps ├── Optimize Solutions ║
║ ├── Trie ├── Mock Interviews ║
║ ├── Segment Trees └── Real-world Projects ║
║ └── Disjoint Sets ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════╝
| Phase | Focus | Topics | Est. Time |
|---|---|---|---|
| 1 | Foundations | Python basics, control flow, functions | 2 weeks |
| 2 | Data Structures | Arrays, strings, hash tables, linked lists, trees, graphs | 4 weeks |
| 3 | Basic Algorithms | Searching, sorting, recursion | 3 weeks |
| 4 | Advanced DS | Heaps, trie, segment trees, disjoint sets | 3 weeks |
| 5 | Patterns | 15+ coding patterns for interviews | 4 weeks |
| 6 | Advanced Algorithms | DP, graph algorithms, greedy | 4 weeks |
| 7 | Challenges | 300+ LeetCode problems | Ongoing |
| 8 | Mastery | Optimization, mock interviews, projects | Ongoing |
OCTALUM-PYLAB/
├── 📥 intake/ # Getting started & onboarding
│ └── README.md
│
├── 🏗️ build/ # Core learning content
│ ├── foundations/ # Phase 1: Python fundamentals
│ │ ├── 01-python-basics/
│ │ ├── 02-control-flow/
│ │ └── 03-functions/
│ ├── data-structures/ # Phase 2-4: DS implementations
│ │ ├── 01-arrays-lists/
│ │ ├── 02-strings/
│ │ ├── 03-hash-tables/
│ │ ├── 04-linked-lists/
│ │ ├── 05-stacks-queues/
│ │ ├── 06-trees/
│ │ ├── 07-graphs/
│ │ └── 08-advanced/
│ ├── algorithms/ # Phase 3, 6: Algorithm implementations
│ │ ├── 01-searching/
│ │ ├── 02-sorting/
│ │ ├── 03-recursion/
│ │ ├── 04-dynamic-programming/
│ │ ├── 05-graph-algorithms/
│ │ ├── 06-greedy/
│ │ └── 07-string-algorithms/
│ ├── patterns/ # Phase 5: Coding patterns
│ │ ├── sliding-window/
│ │ ├── two-pointers/
│ │ ├── fast-slow-pointers/
│ │ ├── merge-intervals/
│ │ ├── cyclic-sort/
│ │ └── ... (10+ more)
│ └── challenges/ # Phase 7: LeetCode problems
│ ├── leetcode-easy/
│ ├── leetcode-medium/
│ ├── leetcode-hard/
│ └── system-design/
│
├── 🔬 verify/ # Testing & quality assurance
│ ├── tests/ # Test suites
│ └── coverage/ # Coverage reports
│
├── 🚀 ship/ # Deployment & tooling
│ ├── .devcontainer/ # GitHub Codespaces config
│ ├── docker/ # Docker configurations
│ └── scripts/ # Utility scripts
│
├── 📚 learn/ # Resources & visualizations
│ ├── cheatsheets/ # Quick reference guides
│ ├── notebooks/ # Jupyter notebooks
│ └── visualizations/ # Algorithm animations
│
├── 📜 record/ # Documentation
│ └── docs/ # MkDocs source
│
├── 🔐 govern/ # Security & compliance
│
├── .github/ # GitHub configurations
│ ├── workflows/ # CI/CD pipelines
│ ├── ISSUE_TEMPLATE/
│ └── PULL_REQUEST_TEMPLATE.md
│
├── pyproject.toml # Project configuration
├── .python-version # Python version (3.12)
└── README.md # This file
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch (
git checkout -b feat/amazing-feature) - Commit your changes using conventional commits
- Push to your branch
- Open a Pull Request
This project uses:
- Ruff for linting and formatting
- Pyright for type checking
- Pytest for testing
# Format code
uv run ruff format .
# Check linting
uv run ruff check .
# Type check
uv run pyright build/
# Run tests
uv run pytest verify/tests -v| Metric | Count |
|---|---|
| 📝 Learning Modules | 50+ |
| 🧩 Coding Patterns | 15+ |
| 🏆 LeetCode Problems | 300+ |
| 📊 Visual Animations | 100+ |
| ✅ Test Coverage | Growing |
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
OCTALUM-PYLAB - Master Python Data Structures & Algorithms
Copyright (C) 2026 OCTALUME
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
- Python Software Foundation for the amazing language
- LeetCode for the problem platform
- Design Gurus for pattern-based learning inspiration
- The Open Source Community for continuous support
Bringing Light to Every Phase of Development
Report Bug • Request Feature • Discussions
Made with ❤️ by OCTALUME