ragulpalanisamy · ragulpalanisamy · Feb 9, 2026 · Feb 9, 2026
diff --git a/architecture/architecture.png → ...e/00_python_architecture/architecture.png b/architecture/architecture.png → ...e/00_python_architecture/architecture.png
diff --git a/architecture/00_python_architecture/index.md b/architecture/00_python_architecture/index.md
@@ -0,0 +1,135 @@
+# 🐍 Python Architecture
+
+> **How Python runs your code** - explained visually
+
+---
+
+## 📚 Two Types of Languages
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                                                             │
+│  HLL (High-Level Language)        LLL (Low-Level Language) │
+│  ✍️  Human-Readable                🤖 Machine-Readable      │
+│                                                             │
+│  Example: Python, Java            Example: 0101010101      │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🔄 How Code Runs
+
+### Traditional Languages (C, C++)
+
+```
+📝 Source Code  →  🔨 Compiler  →  ⚙️  Machine Code  →  ✅ Run
+   (You write)      (Translates)     (Computer runs)
+```
+
+### Python's Way
+
+```
+📝 Source Code  →  🔨 Compiler  →  📦 Bytecode  →  🐍 PVM  →  ⚙️  Machine Code  →  ✅ Run
+   (You write)      (Translates)    (.pyc file)   (Interprets)  (Computer runs)
+```
+
+---
+
+## 🎯 Python Execution in 2 Phases
+
+### Example: `print("Hello")`
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                    ⏱️  COMPILE TIME                          │
+├──────────────────────────────────────────────────────────────┤
+│                                                              │
+│   print("Hello")  →  Compiler  →  Bytecode (.pyc)          │
+│                                                              │
+│   ✓ Check syntax                                            │
+│   ✓ Convert to intermediate code                            │
+│                                                              │
+└──────────────────────────────────────────────────────────────┘
+
+┌──────────────────────────────────────────────────────────────┐
+│                    🚀 RUNTIME                                │
+├──────────────────────────────────────────────────────────────┤
+│                                                              │
+│   Bytecode  →  PVM  →  Machine Code  →  Output: Hello      │
+│                                                              │
+│   ✓ Load bytecode                                           │
+│   ✓ Interpret line-by-line                                  │
+│   ✓ Execute on CPU                                          │
+│                                                              │
+└──────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🖼️ Visual Architecture
+
+![Python Architecture Diagram](architecture.png)
+
+### Legend
+
+| Symbol | Meaning                             |
+| ------ | ----------------------------------- |
+| 📝     | Your Python code (.py file)         |
+| 🔨     | Compiler (converts to bytecode)     |
+| 📦     | Bytecode (.pyc - intermediate code) |
+| 🐍     | PVM (Python Virtual Machine)        |
+| ⚙️     | Machine code (runs on CPU)          |
+
+---
+
+## 💡 Key Points
+
+```
+✅ Python = Compiler + Interpreter (hybrid)
+✅ Bytecode = Platform-independent (works anywhere)
+✅ PVM = Translates bytecode to machine code
+✅ Two phases = Compile time + Runtime
+```
+
+---
+
+## 🔍 Quick Comparison
+
+| Feature       | Traditional (C/C++)  | Python                  |
+| ------------- | -------------------- | ----------------------- |
+| **Steps**     | 1 (Direct compile)   | 2 (Compile → Interpret) |
+| **Output**    | Machine code         | Bytecode → Machine code |
+| **Portable?** | ❌ Platform-specific | ✅ Cross-platform       |
+| **Speed**     | ⚡ Faster            | 🐢 Slower (but easier)  |
+
+---
+
+## 🌍 Platform Independent
+
+**Write Once, Run Anywhere!**
+
+![Platform Independence](platform.png)
+
+### How It Works
+
+```
+Same Python Code (.py)
+         ↓
+   Same Bytecode (.pyc)
+         ↓
+    ┌────┴────┬────────┬────────┐
+    ↓         ↓        ↓        ↓
+  Windows   macOS   Linux   Any OS
+    ↓         ↓        ↓        ↓
+  Intel     ARM      AMD    Any CPU
+    ↓         ↓        ↓        ↓
+   ✅ Works  ✅ Works ✅ Works ✅ Works
+```
+
+**Key Benefit:** Python bytecode runs on any OS/Processor with Python installed!
+
+---
+
+_Updated: Feb 2026_
diff --git a/architecture/platform.png → ...cture/00_python_architecture/platform.png b/architecture/platform.png → ...cture/00_python_architecture/platform.png
diff --git a/architecture/operators/index.md → architecture/01_operators/index.md b/architecture/operators/index.md → architecture/01_operators/index.md
diff --git a/architecture/strings/index.md → architecture/02_strings/index.md b/architecture/strings/index.md → architecture/02_strings/index.md
diff --git a/architecture/type-check-casting/index.md → architecture/03_type_check_casting/index.md b/architecture/type-check-casting/index.md → architecture/03_type_check_casting/index.md
diff --git a/architecture/input/index.md → architecture/04_input/index.md b/architecture/input/index.md → architecture/04_input/index.md
diff --git a/...ure/variable-scope-and-life-time/index.md → architecture/05_variable_scope/index.md b/...ure/variable-scope-and-life-time/index.md → architecture/05_variable_scope/index.md
diff --git a/architecture/control-flow/index.md → architecture/06_control_flow/index.md b/architecture/control-flow/index.md → architecture/06_control_flow/index.md
diff --git a/architecture/functions/index.md → architecture/07_functions/index.md b/architecture/functions/index.md → architecture/07_functions/index.md
diff --git a/architecture/data-structures/index.md → architecture/08_data_structures/index.md b/architecture/data-structures/index.md → architecture/08_data_structures/index.md
diff --git a/architecture/oop/index.md → architecture/09_oop/index.md b/architecture/oop/index.md → architecture/09_oop/index.md
diff --git a/architecture/oop/methods.md → architecture/09_oop/methods.md b/architecture/oop/methods.md → architecture/09_oop/methods.md
diff --git a/architecture/file-handling/file-handling.png → ...ecture/10_file_handling/file-handling.png b/architecture/file-handling/file-handling.png → ...ecture/10_file_handling/file-handling.png
diff --git a/architecture/file-handling/index.md → architecture/10_file_handling/index.md b/architecture/file-handling/index.md → architecture/10_file_handling/index.md
diff --git a/...exception-handling/exception-handling.png → ...exception_handling/exception-handling.png b/...exception-handling/exception-handling.png → ...exception_handling/exception-handling.png
diff --git a/architecture/exception-handling/index.md → architecture/11_exception_handling/index.md b/architecture/exception-handling/index.md → architecture/11_exception_handling/index.md
diff --git a/architecture/PEP-8/PEP-8.md → architecture/12_pep8/PEP-8.md b/architecture/PEP-8/PEP-8.md → architecture/12_pep8/PEP-8.md
diff --git a/...fastapi-rest-api/docs/NODEJS_TO_PYTHON.md → ...fastapi_rest_api/docs/NODEJS_TO_PYTHON.md b/...fastapi-rest-api/docs/NODEJS_TO_PYTHON.md → ...fastapi_rest_api/docs/NODEJS_TO_PYTHON.md
diff --git a/architecture/fastapi-rest-api/index.md → architecture/13_fastapi_rest_api/index.md b/architecture/fastapi-rest-api/index.md → architecture/13_fastapi_rest_api/index.md
diff --git a/architecture/index.md b/architecture/index.md
@@ -1,3 +1,32 @@
+# 🎓 Python Learning Path
+
+> **Welcome to the Python Starter Kit!** This guide is organized sequentially to take you from basics to advanced concepts. Follow the sequence below for the best learning experience.
+
+---
+
+## 🚀 Learning Sequence
+
+| Step | Topic                   | 📖 Documentation                               | 💻 Code Examples                                      |
+| :--- | :---------------------- | :--------------------------------------------- | :---------------------------------------------------- |
+| 00   | **Python Architecture** | [Read Below](#python-architecture)             | -                                                     |
+| 01   | **Operators**           | [View Guide](./01_operators/index.md)          | [Explore Code](../starter_kit/01_operators/)          |
+| 02   | **Strings**             | [View Guide](./02_strings/index.md)            | [Explore Code](../starter_kit/02_strings/)            |
+| 03   | **Type Casting**        | [View Guide](./03_type_check_casting/index.md) | [Explore Code](../starter_kit/03_type_check_casting/) |
+| 04   | **User Input**          | [View Guide](./04_input/index.md)              | [Explore Code](../starter_kit/04_input/)              |
+| 05   | **Variable Scope**      | [View Guide](./05_variable_scope/index.md)     | [Explore Code](../starter_kit/05_variable_scope/)     |
+| 06   | **Control Flow**        | [View Guide](./06_control_flow/index.md)       | [Explore Code](../starter_kit/06_control_flow/)       |
+| 07   | **Functions**           | [View Guide](./07_functions/index.md)          | [Explore Code](../starter_kit/07_functions/)          |
+| 08   | **Data Structures**     | [View Guide](./08_data_structures/index.md)    | [Explore Code](../starter_kit/08_data_structures/)    |
+| 09   | **OOP Concepts**        | [View Guide](./09_oop/index.md)                | [Explore Code](../starter_kit/09_oop/)                |
+| 10   | **File Handling**       | [View Guide](./10_file_handling/index.md)      | [Explore Code](../starter_kit/10_file_handling/)      |
+| 11   | **Exception Handling**  | [View Guide](./11_exception_handling/index.md) | [Explore Code](../starter_kit/11_exception_handling/) |
+| 12   | **PEP-8 Style Guide**   | [View Guide](./12_pep8/index.md)               | -                                                     |
+| 13   | **FastAPI REST API**    | [View Guide](./13_fastapi_rest_api/index.md)   | [Explore Code](../fastapi-starter/)                   |
+
+---
+
+<div id="python-architecture"></div>
+
 # 🐍 Python Architecture
 
 > **How Python runs your code** - explained visually
@@ -70,7 +99,7 @@
 
 ## 🖼️ Visual Architecture
 
-![Python Architecture Diagram](architecture.png)
+![Python Architecture Diagram](./00_python_architecture/architecture.png)
 
 ### Legend
 
@@ -110,7 +139,7 @@
 
 **Write Once, Run Anywhere!**
 
-![Platform Independence](platform.png)
+![Platform Independence](./00_python_architecture/platform.png)
 
 ### How It Works
 

diff --git a/starter_kit/operators/arithmetic.py → starter_kit/01_operators/arithmetic.py b/starter_kit/operators/arithmetic.py → starter_kit/01_operators/arithmetic.py
diff --git a/starter_kit/operators/assignment.py → starter_kit/01_operators/assignment.py b/starter_kit/operators/assignment.py → starter_kit/01_operators/assignment.py
diff --git a/starter_kit/operators/bitwise.py → starter_kit/01_operators/bitwise.py b/starter_kit/operators/bitwise.py → starter_kit/01_operators/bitwise.py
diff --git a/starter_kit/operators/comparison.py → starter_kit/01_operators/comparison.py b/starter_kit/operators/comparison.py → starter_kit/01_operators/comparison.py
diff --git a/starter_kit/operators/identity.py → starter_kit/01_operators/identity.py b/starter_kit/operators/identity.py → starter_kit/01_operators/identity.py
diff --git a/starter_kit/operators/logical.py → starter_kit/01_operators/logical.py b/starter_kit/operators/logical.py → starter_kit/01_operators/logical.py
diff --git a/starter_kit/operators/membership.py → starter_kit/01_operators/membership.py b/starter_kit/operators/membership.py → starter_kit/01_operators/membership.py
diff --git a/starter_kit/strings/basics.py → starter_kit/02_strings/basics.py b/starter_kit/strings/basics.py → starter_kit/02_strings/basics.py
diff --git a/starter_kit/strings/formatting.py → starter_kit/02_strings/formatting.py b/starter_kit/strings/formatting.py → starter_kit/02_strings/formatting.py
diff --git a/starter_kit/strings/methods.py → starter_kit/02_strings/methods.py b/starter_kit/strings/methods.py → starter_kit/02_strings/methods.py
diff --git a/starter_kit/strings/practical.py → starter_kit/02_strings/practical.py b/starter_kit/strings/practical.py → starter_kit/02_strings/practical.py
diff --git a/starter_kit/type-check-casting/index.py → starter_kit/03_type_check_casting/index.py b/starter_kit/type-check-casting/index.py → starter_kit/03_type_check_casting/index.py
diff --git a/starter_kit/input/index.py → starter_kit/04_input/index.py b/starter_kit/input/index.py → starter_kit/04_input/index.py
diff --git a/starter_kit/variable-scope/built-in.py → starter_kit/05_variable_scope/built-in.py b/starter_kit/variable-scope/built-in.py → starter_kit/05_variable_scope/built-in.py
diff --git a/...it/variable-scope/complete-work-around.py → ...05_variable_scope/complete-work-around.py b/...it/variable-scope/complete-work-around.py → ...05_variable_scope/complete-work-around.py
diff --git a/..._kit/variable-scope/enclosing-variable.py → ...t/05_variable_scope/enclosing-variable.py b/..._kit/variable-scope/enclosing-variable.py → ...t/05_variable_scope/enclosing-variable.py
diff --git a/...ter_kit/variable-scope/global-variable.py → ..._kit/05_variable_scope/global-variable.py b/...ter_kit/variable-scope/global-variable.py → ..._kit/05_variable_scope/global-variable.py
diff --git a/starter_kit/variable-scope/local-variable.py → ...r_kit/05_variable_scope/local-variable.py b/starter_kit/variable-scope/local-variable.py → ...r_kit/05_variable_scope/local-variable.py
diff --git a/starter_kit/control-flow/conditionals.py → starter_kit/06_control_flow/conditionals.py b/starter_kit/control-flow/conditionals.py → starter_kit/06_control_flow/conditionals.py
diff --git a/starter_kit/control-flow/for-loops.py → starter_kit/06_control_flow/for-loops.py b/starter_kit/control-flow/for-loops.py → starter_kit/06_control_flow/for-loops.py
diff --git a/starter_kit/control-flow/loop-control.py → starter_kit/06_control_flow/loop-control.py b/starter_kit/control-flow/loop-control.py → starter_kit/06_control_flow/loop-control.py
diff --git a/starter_kit/control-flow/practical.py → starter_kit/06_control_flow/practical.py b/starter_kit/control-flow/practical.py → starter_kit/06_control_flow/practical.py
diff --git a/starter_kit/control-flow/while-loops.py → starter_kit/06_control_flow/while-loops.py b/starter_kit/control-flow/while-loops.py → starter_kit/06_control_flow/while-loops.py
diff --git a/starter_kit/functions/arguments.py → starter_kit/07_functions/arguments.py b/starter_kit/functions/arguments.py → starter_kit/07_functions/arguments.py
diff --git a/starter_kit/functions/basics.py → starter_kit/07_functions/basics.py b/starter_kit/functions/basics.py → starter_kit/07_functions/basics.py
diff --git a/starter_kit/functions/lambda-special.py → starter_kit/07_functions/lambda-special.py b/starter_kit/functions/lambda-special.py → starter_kit/07_functions/lambda-special.py
diff --git a/starter_kit/functions/practical.py → starter_kit/07_functions/practical.py b/starter_kit/functions/practical.py → starter_kit/07_functions/practical.py
diff --git a/starter_kit/functions/scope.py → starter_kit/07_functions/scope.py b/starter_kit/functions/scope.py → starter_kit/07_functions/scope.py
diff --git a/...it/data-structures/dictionaries/basics.py → ...08_data_structures/dictionaries/basics.py b/...it/data-structures/dictionaries/basics.py → ...08_data_structures/dictionaries/basics.py
diff --git a/starter_kit/data-structures/lists/basics.py → ...er_kit/08_data_structures/lists/basics.py b/starter_kit/data-structures/lists/basics.py → ...er_kit/08_data_structures/lists/basics.py
diff --git a/starter_kit/data-structures/lists/methods.py → ...r_kit/08_data_structures/lists/methods.py b/starter_kit/data-structures/lists/methods.py → ...r_kit/08_data_structures/lists/methods.py
diff --git a/...r_kit/data-structures/lists/operations.py → ...it/08_data_structures/lists/operations.py b/...r_kit/data-structures/lists/operations.py → ...it/08_data_structures/lists/operations.py
diff --git a/...er_kit/data-structures/lists/practical.py → ...kit/08_data_structures/lists/practical.py b/...er_kit/data-structures/lists/practical.py → ...kit/08_data_structures/lists/practical.py
diff --git a/starter_kit/data-structures/sets/basics.py → ...ter_kit/08_data_structures/sets/basics.py b/starter_kit/data-structures/sets/basics.py → ...ter_kit/08_data_structures/sets/basics.py
diff --git a/starter_kit/data-structures/tuples/basics.py → ...r_kit/08_data_structures/tuples/basics.py b/starter_kit/data-structures/tuples/basics.py → ...r_kit/08_data_structures/tuples/basics.py
diff --git a/starter_kit/oop/abstraction.py → starter_kit/09_oop/abstraction.py b/starter_kit/oop/abstraction.py → starter_kit/09_oop/abstraction.py
diff --git a/starter_kit/oop/class-basics.py → starter_kit/09_oop/class-basics.py b/starter_kit/oop/class-basics.py → starter_kit/09_oop/class-basics.py
diff --git a/starter_kit/oop/encapsulation.py → starter_kit/09_oop/encapsulation.py b/starter_kit/oop/encapsulation.py → starter_kit/09_oop/encapsulation.py
diff --git a/starter_kit/oop/inheritance.py → starter_kit/09_oop/inheritance.py b/starter_kit/oop/inheritance.py → starter_kit/09_oop/inheritance.py
diff --git a/starter_kit/oop/methods-comparison.py → starter_kit/09_oop/methods-comparison.py b/starter_kit/oop/methods-comparison.py → starter_kit/09_oop/methods-comparison.py
diff --git a/starter_kit/oop/no-constructor.py → starter_kit/09_oop/no-constructor.py b/starter_kit/oop/no-constructor.py → starter_kit/09_oop/no-constructor.py
diff --git a/starter_kit/oop/polymorphism.py → starter_kit/09_oop/polymorphism.py b/starter_kit/oop/polymorphism.py → starter_kit/09_oop/polymorphism.py
diff --git a/starter_kit/oop/practical.py → starter_kit/09_oop/practical.py b/starter_kit/oop/practical.py → starter_kit/09_oop/practical.py
diff --git a/starter_kit/file-handling/basics.py → starter_kit/10_file_handling/basics.py b/starter_kit/file-handling/basics.py → starter_kit/10_file_handling/basics.py
diff --git a/starter_kit/file-handling/practical.py → starter_kit/10_file_handling/practical.py b/starter_kit/file-handling/practical.py → starter_kit/10_file_handling/practical.py
diff --git a/starter_kit/exception-handling/basics.py → starter_kit/11_exception_handling/basics.py b/starter_kit/exception-handling/basics.py → starter_kit/11_exception_handling/basics.py
diff --git a/...t/exception-handling/common-exceptions.py → ...1_exception_handling/common-exceptions.py b/...t/exception-handling/common-exceptions.py → ...1_exception_handling/common-exceptions.py
diff --git a/starter_kit/exception-handling/practical.py → ...er_kit/11_exception_handling/practical.py b/starter_kit/exception-handling/practical.py → ...er_kit/11_exception_handling/practical.py
diff --git a/.../exception-handling/raising-exceptions.py → ..._exception_handling/raising-exceptions.py b/.../exception-handling/raising-exceptions.py → ..._exception_handling/raising-exceptions.py
diff --git a/starter_kit/exception-handling/test.txt → starter_kit/11_exception_handling/test.txt b/starter_kit/exception-handling/test.txt → starter_kit/11_exception_handling/test.txt