pytoch-dl 1.0.0__tar.gz

pytoch_dl-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antigravity Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pytoch_dl-1.0.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: pytoch-dl
+Version: 1.0.0
+Summary: Deep Learning Practicals, Customization Recipes, Theory Explainers & Bundled Datasets
+Author: Antigravity Team
+License: MIT
+Keywords: deep-learning,pytorch,tensorflow,keras,neural-networks,mnist,imdb,recipes
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Dynamic: license-file
+Dynamic: requires-python
+
+# pytoch
+
+> **Deep Learning Practicals, Customization Recipes, Mathematical Theory Explainers & Bundled Datasets**
+
+`pytoch` is a self-contained, discrete, and modular Deep Learning reference library. It bundles complete implementations for 9 foundational deep learning practicals across NumPy, TensorFlow/Keras, and PyTorch, complete with customization recipes, mathematical theory explainers with viva Q&A, and offline datasets (`mnist.csv` and `imdb.csv`).
+
+---
+
+## Key Features
+
+1. **All 9 Deep Learning Practicals**:
+   - Discrete, modular implementations free of academic markers, student names, or roll numbers.
+   - Clean cell-by-cell inspection or complete script views.
+2. **Built-in Customization Recipes**:
+   - Detailed guides on dataset swapping (Pandas CSV, torchvision/keras datasets, custom folders).
+   - Optimizer switching (Adam, SGD + Nesterov momentum, RMSprop, AdamW).
+   - Learning rate schedules, regularizers (L1, L2, Dropout), and modern activation functions.
+3. **Comprehensive Theory & Viva Explainers**:
+   - Mathematical formulations, forward/backward derivations, loss functions, and gradient mechanics.
+   - Top viva questions and definitive technical answers.
+4. **Bundled Datasets & Pull Utility**:
+   - Bundles `mnist.csv` (20,000 tabular digit pixels, 35MB) and `imdb.csv` (10,000 movie reviews, 12MB) directly in package data.
+   - One-command extraction to any folder on your machine (`pytoch.pull_datasets("./data")`).
+   - Direct pandas loader without copying: `pytoch.load_mnist()`.
+
+---
+
+## Catalog of Practicals
+
+| # | Practical Title | Framework | Dataset |
+|---|----------------|-----------|---------|
+| 1 | Single-Layer Perceptron (AND / OR Gates) | NumPy / Matplotlib | Logic Tables |
+| 2 | 3-Layer Multi-Layer Perceptron (MLP) | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 3 | Neural Network Regularization (L2 Decay vs Dropout) | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 4 | Activation Functions (Sigmoid vs Tanh vs ReLU) | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 5 | CNN vs. MLP with Data Augmentation | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 6 | Sequential LSTM for Sentiment Analysis | TensorFlow / Keras + Pandas | `imdb.csv` |
+| 7 | Transfer Learning & Fine-Tuning (MobileNetV2) | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 8 | Dynamic PyTorch MLP & Hyperparameter Grid Search | PyTorch + Pandas + TensorBoard | `mnist.csv` |
+| 9 | Deep CNN Micro-Project with Dynamic Callbacks | TensorFlow / Keras + Pandas | `mnist.csv` |
+
+---
+
+## Python API Usage
+
+```python
+import pytoch
+
+# 1. Dataset Management
+pytoch.list_datasets()
+pytoch.pull_datasets(target_dir="./data") # Extracts mnist.csv & imdb.csv
+X, y = pytoch.load_mnist() # Load directly into memory
+
+# 2. View Code & Practicals
+pytoch.list_practicals()
+pytoch.show(2)         # Full Practical 2 code
+pytoch.show(2, cell=1) # View specific cell
+
+# 3. Customization Recipes
+pytoch.recipes(2)      # How to swap datasets, optimizers, loss functions
+
+# 4. Theory & Viva Explainer
+pytoch.theory(2)       # Mathematical derivations, equations, and viva Q&A
+
+# 5. Combined View
+pytoch.show(2, recipes=True, theory=True)
+```
+
+---
+
+## CLI Usage
+
+```bash
+# View help and cheat sheet
+pytoch guide
+
+# List all practicals
+pytoch list
+
+# Display code
+pytoch show 2
+pytoch show 2 --cell 1
+
+# Display recipes and theory
+pytoch recipes 2
+pytoch theory 2
+
+# Extract bundled datasets to ./data
+pytoch pull-data --out-dir ./data
+
+# View bundled datasets catalog
+pytoch datasets
+```
+
+---
+
+## License
+
+MIT License.

pytoch_dl-1.0.0/README.md

@@ -0,0 +1,99 @@
+# pytoch
+
+> **Deep Learning Practicals, Customization Recipes, Mathematical Theory Explainers & Bundled Datasets**
+
+`pytoch` is a self-contained, discrete, and modular Deep Learning reference library. It bundles complete implementations for 9 foundational deep learning practicals across NumPy, TensorFlow/Keras, and PyTorch, complete with customization recipes, mathematical theory explainers with viva Q&A, and offline datasets (`mnist.csv` and `imdb.csv`).
+
+---
+
+## Key Features
+
+1. **All 9 Deep Learning Practicals**:
+   - Discrete, modular implementations free of academic markers, student names, or roll numbers.
+   - Clean cell-by-cell inspection or complete script views.
+2. **Built-in Customization Recipes**:
+   - Detailed guides on dataset swapping (Pandas CSV, torchvision/keras datasets, custom folders).
+   - Optimizer switching (Adam, SGD + Nesterov momentum, RMSprop, AdamW).
+   - Learning rate schedules, regularizers (L1, L2, Dropout), and modern activation functions.
+3. **Comprehensive Theory & Viva Explainers**:
+   - Mathematical formulations, forward/backward derivations, loss functions, and gradient mechanics.
+   - Top viva questions and definitive technical answers.
+4. **Bundled Datasets & Pull Utility**:
+   - Bundles `mnist.csv` (20,000 tabular digit pixels, 35MB) and `imdb.csv` (10,000 movie reviews, 12MB) directly in package data.
+   - One-command extraction to any folder on your machine (`pytoch.pull_datasets("./data")`).
+   - Direct pandas loader without copying: `pytoch.load_mnist()`.
+
+---
+
+## Catalog of Practicals
+
+| # | Practical Title | Framework | Dataset |
+|---|----------------|-----------|---------|
+| 1 | Single-Layer Perceptron (AND / OR Gates) | NumPy / Matplotlib | Logic Tables |
+| 2 | 3-Layer Multi-Layer Perceptron (MLP) | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 3 | Neural Network Regularization (L2 Decay vs Dropout) | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 4 | Activation Functions (Sigmoid vs Tanh vs ReLU) | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 5 | CNN vs. MLP with Data Augmentation | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 6 | Sequential LSTM for Sentiment Analysis | TensorFlow / Keras + Pandas | `imdb.csv` |
+| 7 | Transfer Learning & Fine-Tuning (MobileNetV2) | TensorFlow / Keras + Pandas | `mnist.csv` |
+| 8 | Dynamic PyTorch MLP & Hyperparameter Grid Search | PyTorch + Pandas + TensorBoard | `mnist.csv` |
+| 9 | Deep CNN Micro-Project with Dynamic Callbacks | TensorFlow / Keras + Pandas | `mnist.csv` |
+
+---
+
+## Python API Usage
+
+```python
+import pytoch
+
+# 1. Dataset Management
+pytoch.list_datasets()
+pytoch.pull_datasets(target_dir="./data") # Extracts mnist.csv & imdb.csv
+X, y = pytoch.load_mnist() # Load directly into memory
+
+# 2. View Code & Practicals
+pytoch.list_practicals()
+pytoch.show(2)         # Full Practical 2 code
+pytoch.show(2, cell=1) # View specific cell
+
+# 3. Customization Recipes
+pytoch.recipes(2)      # How to swap datasets, optimizers, loss functions
+
+# 4. Theory & Viva Explainer
+pytoch.theory(2)       # Mathematical derivations, equations, and viva Q&A
+
+# 5. Combined View
+pytoch.show(2, recipes=True, theory=True)
+```
+
+---
+
+## CLI Usage
+
+```bash
+# View help and cheat sheet
+pytoch guide
+
+# List all practicals
+pytoch list
+
+# Display code
+pytoch show 2
+pytoch show 2 --cell 1
+
+# Display recipes and theory
+pytoch recipes 2
+pytoch theory 2
+
+# Extract bundled datasets to ./data
+pytoch pull-data --out-dir ./data
+
+# View bundled datasets catalog
+pytoch datasets
+```
+
+---
+
+## License
+
+MIT License.

pytoch_dl-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pytoch-dl"
+version = "1.0.0"
+description = "Deep Learning Practicals, Customization Recipes, Theory Explainers & Bundled Datasets"
+readme = "README.md"
+requires-python = ">=3.6"
+license = {text = "MIT"}
+authors = [
+    {name = "Antigravity Team"}
+]
+keywords = ["deep-learning", "pytorch", "tensorflow", "keras", "neural-networks", "mnist", "imdb", "recipes"]
+dependencies = [
+    "pandas"
+]
+
+[project.scripts]
+pytoch = "pytoch.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pytoch = ["data/*", "data/*/*"]

pytoch_dl-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pytoch_dl-1.0.0/setup.py

@@ -0,0 +1,31 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="pytoch-dl",
+    version="1.0.0",
+    description="Deep Learning Practicals, Customization Recipes, Theory Explainers & Bundled Datasets",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="Antigravity Team",
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    package_data={
+        "pytoch": ["data/*", "data/*/*"]
+    },
+    include_package_data=True,
+    python_requires=">=3.6",
+    install_requires=[
+        "pandas",
+    ],
+    entry_points={
+        "console_scripts": [
+            "pytoch=pytoch.cli:main",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    ],
+)

pytoch_dl-1.0.0/src/pytoch/__init__.py

@@ -0,0 +1,167 @@
+"""
+pytoch: Deep Learning Practicals, Customization Recipes, Theory Explainers & Bundled Datasets.
+"""
+
+from .core import Pytoch
+from .datasets import (
+    pull_datasets,
+    get_dataset,
+    get_dataset_path,
+    list_datasets,
+    load_mnist,
+    load_imdb,
+)
+from .recipes import get_recipe, print_recipe, list_recipes
+from .theory import get_theory, print_theory, list_theory
+
+_default_instance = Pytoch()
+
+# Core Navigation & Guide
+def guide():
+    """Display the pytoch quickstart guide and cheatsheet."""
+    _default_instance.guide()
+
+help = guide
+quickstart = guide
+
+def list_practicals():
+    """List all available deep learning practicals."""
+    _default_instance.list_practicals()
+
+list_codes = list_practicals
+list_architectures = list_practicals
+entries = list_practicals
+list_entries = list_practicals
+
+def show(num, cell=None, recipes=False, theory=False):
+    """Display practical code, optional recipes, and optional theory."""
+    _default_instance.show(num, cell=cell, recipes=recipes, theory=theory)
+
+practical = show
+code = show
+architecture = show
+
+def recipes(num):
+    """View customization recipes for practical num."""
+    _default_instance.recipes(num)
+
+tweaks = recipes
+
+def theory(num):
+    """View theoretical foundation, equations, and viva explainer for practical num."""
+    _default_instance.theory(num)
+
+explain = theory
+
+def viva(num=None):
+    """View Viva Examination questions and answers for practical num (or all if None)."""
+    _default_instance.viva(num)
+
+def get_viva(num=None):
+    """Retrieve Viva Examination questions and answers string for practical num."""
+    return _default_instance.get_viva(num)
+
+# Getter functions (returns string / dict)
+def get_practical(num, cell=None, recipes=False, theory=False):
+    """Retrieve practical code string."""
+    return _default_instance.get_practical(num, cell=cell, recipes=recipes, theory=theory)
+
+get_code = get_practical
+get_architecture = get_practical
+
+def get_recipes(num):
+    """Retrieve customization recipes string."""
+    return _default_instance.get_recipes(num)
+
+get_tweaks = get_recipes
+
+def get_theory(num):
+    """Retrieve theoretical explainer string."""
+    return _default_instance.get_theory(num)
+
+def get_cells(num):
+    """Retrieve list of cell dicts for practical num."""
+    return _default_instance.get_cells(num)
+
+# Practical-specific Shortcuts
+def perceptron(cell=None, recipes=False, theory=False):
+    """Practical 1: Single-Layer Perceptron (AND & OR Gates)."""
+    _default_instance.perceptron(cell=cell, recipes=recipes, theory=theory)
+
+def mlp(cell=None, recipes=False, theory=False):
+    """Practical 2: 3-Layer Multi-Layer Perceptron on Local MNIST."""
+    _default_instance.mlp(cell=cell, recipes=recipes, theory=theory)
+
+def regularization(cell=None, recipes=False, theory=False):
+    """Practical 3: Neural Network Regularization (L2 Decay vs. Dropout)."""
+    _default_instance.regularization(cell=cell, recipes=recipes, theory=theory)
+
+def activations(cell=None, recipes=False, theory=False):
+    """Practical 4: Non-Linear Activation Functions (Sigmoid vs Tanh vs ReLU)."""
+    _default_instance.activations(cell=cell, recipes=recipes, theory=theory)
+
+def cnn(cell=None, recipes=False, theory=False):
+    """Practical 5: CNN vs. MLP with Data Augmentation for Vision."""
+    _default_instance.cnn(cell=cell, recipes=recipes, theory=theory)
+
+def lstm(cell=None, recipes=False, theory=False):
+    """Practical 6: Sequential LSTM Network for Sentiment Analysis."""
+    _default_instance.lstm(cell=cell, recipes=recipes, theory=theory)
+
+def transfer_learning(cell=None, recipes=False, theory=False):
+    """Practical 7: Transfer Learning & Fine-Tuning with MobileNetV2."""
+    _default_instance.transfer_learning(cell=cell, recipes=recipes, theory=theory)
+
+def hparam_tuning(cell=None, recipes=False, theory=False):
+    """Practical 8: Dynamic PyTorch MLP & Hyperparameter Grid Search."""
+    _default_instance.hparam_tuning(cell=cell, recipes=recipes, theory=theory)
+
+def deep_cnn(cell=None, recipes=False, theory=False):
+    """Practical 9: Deep CNN Micro-Project with Dynamic Callbacks."""
+    _default_instance.deep_cnn(cell=cell, recipes=recipes, theory=theory)
+
+__all__ = [
+    "Pytoch",
+    "guide",
+    "help",
+    "quickstart",
+    "list_practicals",
+    "list_codes",
+    "list_architectures",
+    "entries",
+    "list_entries",
+    "show",
+    "practical",
+    "code",
+    "architecture",
+    "recipes",
+    "tweaks",
+    "theory",
+    "explain",
+    "viva",
+    "get_viva",
+    "get_practical",
+    "get_code",
+    "get_architecture",
+    "get_recipes",
+    "get_tweaks",
+    "get_theory",
+    "get_cells",
+    "pull_datasets",
+    "get_dataset",
+    "get_dataset_path",
+    "list_datasets",
+    "load_mnist",
+    "load_imdb",
+    "perceptron",
+    "mlp",
+    "regularization",
+    "activations",
+    "cnn",
+    "lstm",
+    "transfer_learning",
+    "hparam_tuning",
+    "deep_cnn",
+]
+
+__version__ = "1.0.0"

pytoch_dl-1.0.0/src/pytoch/cli.py

@@ -0,0 +1,115 @@
+"""
+pytoch.cli: Command-line interface for the pytoch deep learning suite.
+"""
+
+import argparse
+import sys
+from .core import Pytoch
+from .datasets import pull_datasets, get_dataset, list_datasets
+from .recipes import print_recipe, list_recipes
+from .theory import print_theory, list_theory, print_viva
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="pytoch",
+        description="pytoch: Deep Learning Practicals, Customization Recipes, Theory Explainers & Bundled Datasets"
+    )
+    subparsers = parser.add_subparsers(dest="command", help="Available subcommands")
+
+    # guide
+    subparsers.add_parser("guide", help="Display quickstart cheatsheet")
+
+    # list / entries
+    subparsers.add_parser("list", help="List all 9 practicals")
+    subparsers.add_parser("entries", help="List all 9 practical entries")
+
+    # show
+    show_parser = subparsers.add_parser("show", help="Display practical code")
+    show_parser.add_argument("num", type=int, help="Practical number (1-9)")
+    show_parser.add_argument("--cell", "-c", type=int, default=None, help="Specific cell number")
+    show_parser.add_argument("--recipes", "-r", action="store_true", help="Include customization recipes")
+    show_parser.add_argument("--theory", "-t", action="store_true", help="Include theory & viva explainer")
+
+    # practical (alias for show)
+    p_parser = subparsers.add_parser("practical", help="Display practical code (alias for show)")
+    p_parser.add_argument("num", type=int, help="Practical number (1-9)")
+    p_parser.add_argument("--cell", "-c", type=int, default=None, help="Specific cell number")
+    p_parser.add_argument("--recipes", "-r", action="store_true", help="Include customization recipes")
+    p_parser.add_argument("--theory", "-t", action="store_true", help="Include theory & viva explainer")
+
+    # recipes
+    rec_parser = subparsers.add_parser("recipes", help="Display customization recipes for a practical")
+    rec_parser.add_argument("num", type=int, nargs="?", default=None, help="Practical number (1-9)")
+
+    # theory
+    th_parser = subparsers.add_parser("theory", help="Display theory foundations & viva Q&A for a practical")
+    th_parser.add_argument("num", type=int, nargs="?", default=None, help="Practical number (1-9)")
+
+    # viva
+    viva_parser = subparsers.add_parser("viva", help="Display Viva exam Q&A for a practical")
+    viva_parser.add_argument("num", type=int, nargs="?", default=None, help="Practical number (1-9)")
+
+    # datasets
+    subparsers.add_parser("datasets", help="List bundled datasets and details")
+
+    # pull-data
+    pull_parser = subparsers.add_parser("pull-data", help="Pull bundled datasets into a local directory")
+    pull_parser.add_argument("--out-dir", "-o", default="./data", help="Output directory (default: ./data)")
+    pull_parser.add_argument("--name", "-n", default=None, help="Specific dataset name ('mnist' or 'imdb')")
+    pull_parser.add_argument("--overwrite", action="store_true", help="Overwrite existing files")
+
+    # Parse arguments
+    args = parser.parse_args()
+
+    app = Pytoch()
+
+    if args.command in ("guide", None):
+        app.guide()
+    elif args.command in ("list", "entries"):
+        app.list_practicals()
+    elif args.command in ("show", "practical"):
+        try:
+            app.show(args.num, cell=args.cell, recipes=args.recipes, theory=args.theory)
+        except Exception as e:
+            print(f"[!] Error: {e}", file=sys.stderr)
+            sys.exit(1)
+    elif args.command == "recipes":
+        if args.num is not None:
+            try:
+                print_recipe(args.num)
+            except Exception as e:
+                print(f"[!] Error: {e}", file=sys.stderr)
+                sys.exit(1)
+        else:
+            list_recipes()
+    elif args.command == "theory":
+        if args.num is not None:
+            try:
+                print_theory(args.num)
+            except Exception as e:
+                print(f"[!] Error: {e}", file=sys.stderr)
+                sys.exit(1)
+        else:
+            list_theory()
+    elif args.command == "viva":
+        try:
+            print_viva(args.num)
+        except Exception as e:
+            print(f"[!] Error: {e}", file=sys.stderr)
+            sys.exit(1)
+    elif args.command == "datasets":
+        list_datasets()
+    elif args.command == "pull-data":
+        if args.name:
+            try:
+                get_dataset(args.name, target_dir=args.out_dir, overwrite=args.overwrite)
+            except Exception as e:
+                print(f"[!] Error: {e}", file=sys.stderr)
+                sys.exit(1)
+        else:
+            pull_datasets(target_dir=args.out_dir, overwrite=args.overwrite)
+
+
+if __name__ == "__main__":
+    main()