heroalgorithm 0.1.0__tar.gz

heroalgorithm-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AssignVault Contributors
+
+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.

heroalgorithm-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: heroalgorithm
+Version: 0.1.0
+Summary: Instant AI/ML lab problem sheets, datasets, notebooks, and algorithms vault.
+Author: HeroAlgorithm Maintainer
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AdityaxDeore/heroalgorithm
+Project-URL: Repository, https://github.com/AdityaxDeore/heroalgorithm.git
+Keywords: heroalgorithm,aiml,machine-learning,problem-sheets,datasets,jupyter-notebook,algorithms,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Education
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ⚡ HeroAlgorithm
+
+> **Instant AI/ML Problem Sheets, Datasets & Code Vault**  
+> Download, extract, and organize all your AI & Machine Learning lab assignments, problem sheets, datasets, Jupyter Notebooks (`.ipynb`), and Python scripts cleanly onto your PC with a single command.
+
+[![PyPI Version](https://img.shields.io/pypi/v/heroalgorithm.svg)](https://pypi.org/project/heroalgorithm/)
+[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0%20runtime-brightgreen.svg)]()
+
+---
+
+## 🌟 The Magic Experience
+
+Install and organize all your AI/ML lab problem sheets into `C:\AIML_Assignments` in one step:
+
+```powershell
+pip install heroalgorithm; heroalgorithm
+```
+
+Or run `heroalgorithm` anytime in your terminal:
+
+```powershell
+heroalgorithm
+```
+
+And your C: drive folder is cleanly populated:
+
+```text
+C:\AIML_Assignments\
+├── PS-1/
+│   ├── dataset/
+│   │   └── data.csv
+│   ├── notebook.ipynb
+│   ├── solution.py
+│   └── README.md
+├── PS-2/
+│   ├── dataset/
+│   │   └── housing.csv
+│   ├── notebook.ipynb
+│   ├── solution.py
+│   └── README.md
+└── PS-3/
+    ├── dataset/
+    │   └── iris.csv
+    ├── notebook.ipynb
+    ├── solution.py
+    └── README.md
+```
+
+> **Clean & Quiet by Design:** No noisy spam or "installing file x" lines. Everything stays hidden and extracts quietly into your folder!
+
+---
+
+## 🚀 Key Features
+
+- ⚡ **Bundled Offline Vault**: Problem sheets, datasets, notebooks, and solutions are packaged directly inside the package. Works 100% offline without needing GitHub.
+- 📁 **Automatic C: Drive Placement**: Automatically organizes files into `C:\AIML_Assignments` on Windows (or `~/AIML_Assignments`).
+- 🎯 **Selective Extraction**: Run `heroalgorithm 1` or `heroalgorithm ps-1` to unpack just Problem Sheet 1.
+- 🤫 **Silent Mode**: Zero annoying logs. Use `-q` or `--quiet` for 100% silent execution.
+- 🔄 **GitHub Sync (Optional)**: Connect to a remote GitHub repository anytime with `heroalgorithm config --set-repo <user>/<repo>` to sync the latest assignments.
+- 🪶 **Zero Dependencies**: 100% built on Python's standard library. Instant installation.
+
+---
+
+## 🛠️ Usage Examples
+
+### 1. Extract All Problem Sheets to C:\AIML_Assignments
+```powershell
+heroalgorithm
+```
+
+### 2. Extract Only Problem Sheet 1
+```powershell
+# Shorthand:
+heroalgorithm 1
+
+# Or:
+heroalgorithm ps-1
+```
+
+### 3. Choose a Custom Output Folder
+```powershell
+heroalgorithm -o "D:\MyCollege\AI_Lab"
+```
+
+### 4. Run Completely Silently
+```powershell
+heroalgorithm -q
+```
+
+### 5. Preview Available Problem Sheets
+```powershell
+heroalgorithm list
+```
+
+### 6. Configure Default Destination or Remote Repo
+```powershell
+# Change default destination:
+heroalgorithm config --set-dest "D:\AIML_Lab"
+
+# Connect to a GitHub repository:
+heroalgorithm config --set-repo your-username/aiml-assignments
+
+# Check active configuration:
+heroalgorithm config
+```
+
+---
+
+## 🚢 Publishing to PyPI (Step-by-Step)
+
+The package name **`heroalgorithm`** is verified available on PyPI!
+
+### Step 1: Build the Package
+```powershell
+python -m build
+```
+This creates the distribution files in `dist/`:
+- `heroalgorithm-0.1.0-py3-none-any.whl`
+- `heroalgorithm-0.1.0.tar.gz`
+
+### Step 2: Upload to PyPI
+```powershell
+python -m twine upload dist/*
+```
+*(Enter `__token__` as the username, and paste your PyPI API Token as the password).*
+
+Once published, anyone in the world can run:
+```powershell
+pip install heroalgorithm; heroalgorithm
+```
+
+---
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).

heroalgorithm-0.1.0/README.md

@@ -0,0 +1,138 @@
+# ⚡ HeroAlgorithm
+
+> **Instant AI/ML Problem Sheets, Datasets & Code Vault**  
+> Download, extract, and organize all your AI & Machine Learning lab assignments, problem sheets, datasets, Jupyter Notebooks (`.ipynb`), and Python scripts cleanly onto your PC with a single command.
+
+[![PyPI Version](https://img.shields.io/pypi/v/heroalgorithm.svg)](https://pypi.org/project/heroalgorithm/)
+[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0%20runtime-brightgreen.svg)]()
+
+---
+
+## 🌟 The Magic Experience
+
+Install and organize all your AI/ML lab problem sheets into `C:\AIML_Assignments` in one step:
+
+```powershell
+pip install heroalgorithm; heroalgorithm
+```
+
+Or run `heroalgorithm` anytime in your terminal:
+
+```powershell
+heroalgorithm
+```
+
+And your C: drive folder is cleanly populated:
+
+```text
+C:\AIML_Assignments\
+├── PS-1/
+│   ├── dataset/
+│   │   └── data.csv
+│   ├── notebook.ipynb
+│   ├── solution.py
+│   └── README.md
+├── PS-2/
+│   ├── dataset/
+│   │   └── housing.csv
+│   ├── notebook.ipynb
+│   ├── solution.py
+│   └── README.md
+└── PS-3/
+    ├── dataset/
+    │   └── iris.csv
+    ├── notebook.ipynb
+    ├── solution.py
+    └── README.md
+```
+
+> **Clean & Quiet by Design:** No noisy spam or "installing file x" lines. Everything stays hidden and extracts quietly into your folder!
+
+---
+
+## 🚀 Key Features
+
+- ⚡ **Bundled Offline Vault**: Problem sheets, datasets, notebooks, and solutions are packaged directly inside the package. Works 100% offline without needing GitHub.
+- 📁 **Automatic C: Drive Placement**: Automatically organizes files into `C:\AIML_Assignments` on Windows (or `~/AIML_Assignments`).
+- 🎯 **Selective Extraction**: Run `heroalgorithm 1` or `heroalgorithm ps-1` to unpack just Problem Sheet 1.
+- 🤫 **Silent Mode**: Zero annoying logs. Use `-q` or `--quiet` for 100% silent execution.
+- 🔄 **GitHub Sync (Optional)**: Connect to a remote GitHub repository anytime with `heroalgorithm config --set-repo <user>/<repo>` to sync the latest assignments.
+- 🪶 **Zero Dependencies**: 100% built on Python's standard library. Instant installation.
+
+---
+
+## 🛠️ Usage Examples
+
+### 1. Extract All Problem Sheets to C:\AIML_Assignments
+```powershell
+heroalgorithm
+```
+
+### 2. Extract Only Problem Sheet 1
+```powershell
+# Shorthand:
+heroalgorithm 1
+
+# Or:
+heroalgorithm ps-1
+```
+
+### 3. Choose a Custom Output Folder
+```powershell
+heroalgorithm -o "D:\MyCollege\AI_Lab"
+```
+
+### 4. Run Completely Silently
+```powershell
+heroalgorithm -q
+```
+
+### 5. Preview Available Problem Sheets
+```powershell
+heroalgorithm list
+```
+
+### 6. Configure Default Destination or Remote Repo
+```powershell
+# Change default destination:
+heroalgorithm config --set-dest "D:\AIML_Lab"
+
+# Connect to a GitHub repository:
+heroalgorithm config --set-repo your-username/aiml-assignments
+
+# Check active configuration:
+heroalgorithm config
+```
+
+---
+
+## 🚢 Publishing to PyPI (Step-by-Step)
+
+The package name **`heroalgorithm`** is verified available on PyPI!
+
+### Step 1: Build the Package
+```powershell
+python -m build
+```
+This creates the distribution files in `dist/`:
+- `heroalgorithm-0.1.0-py3-none-any.whl`
+- `heroalgorithm-0.1.0.tar.gz`
+
+### Step 2: Upload to PyPI
+```powershell
+python -m twine upload dist/*
+```
+*(Enter `__token__` as the username, and paste your PyPI API Token as the password).*
+
+Once published, anyone in the world can run:
+```powershell
+pip install heroalgorithm; heroalgorithm
+```
+
+---
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).

heroalgorithm-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=68.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "heroalgorithm"
+version = "0.1.0"
+description = "Instant AI/ML lab problem sheets, datasets, notebooks, and algorithms vault."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    { name = "HeroAlgorithm Maintainer" }
+]
+keywords = [
+    "heroalgorithm",
+    "aiml",
+    "machine-learning",
+    "problem-sheets",
+    "datasets",
+    "jupyter-notebook",
+    "algorithms",
+    "cli"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Education",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Education",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence"
+]
+dependencies = []
+
+[project.scripts]
+heroalgorithm = "heroalgorithm.cli:main"
+hero = "heroalgorithm.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/AdityaxDeore/heroalgorithm"
+Repository = "https://github.com/AdityaxDeore/heroalgorithm.git"
+
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+heroalgorithm = [
+    "assignments/**/*",
+    "assignments/**/.*"
+]

heroalgorithm-0.1.0/setup.cfg

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

heroalgorithm-0.1.0/src/heroalgorithm/__init__.py

@@ -0,0 +1,6 @@
+"""
+HeroAlgorithm - Instant AI/ML Lab Problem Sheets, Datasets & Code Manager.
+"""
+
+__version__ = "0.1.0"
+__all__ = ["__version__"]

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-1/README.md

@@ -0,0 +1,11 @@
+# Problem Sheet 1 (PS-1)
+
+## Objectives
+- Load and preprocess tabular dataset from `dataset/data.csv`.
+- Implement simple classification model.
+- Analyze feature correlation and accuracy metrics.
+
+## Files
+- `dataset/data.csv`: Input training data.
+- `notebook.ipynb`: Interactive analysis & visualization.
+- `solution.py`: Standalone Python implementation script.

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-1/dataset/data.csv

@@ -0,0 +1,7 @@
+feature1,feature2,target
+1.2,3.4,0
+2.5,1.1,0
+5.8,7.9,1
+6.1,8.3,1
+1.9,2.4,0
+7.3,9.1,1

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-1/notebook.ipynb

@@ -0,0 +1,32 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "# PS-1: Linear Classification\n",
+        "\n",
+        "Jupyter Notebook for AIML Lab.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import pandas as pd\n",
+        "import numpy as np\n",
+        "df = pd.read_csv(\"dataset/data.csv\")\n",
+        "df.head()\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-1/solution.py

@@ -0,0 +1,28 @@
+"""
+AIML Problem Sheet 1 (PS-1)
+Linear Regression / Classification Implementation
+"""
+
+import pandas as pd
+from pathlib import Path
+
+
+def load_dataset():
+    data_path = Path(__file__).parent / "dataset" / "data.csv"
+    if not data_path.exists():
+        raise FileNotFoundError(f"Dataset not found at: {data_path}")
+    df = pd.read_csv(data_path)
+    print(f"Loaded dataset with {len(df)} rows:")
+    print(df.head())
+    return df
+
+
+def main():
+    print("Executing PS-1 Solution...")
+    df = load_dataset()
+    print("Features:", [c for c in df.columns if c != "target"])
+    print("Target distribution:", df["target"].value_counts().to_dict())
+
+
+if __name__ == "__main__":
+    main()

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-2/README.md

@@ -0,0 +1,5 @@
+# Problem Sheet 2 (PS-2)
+
+## Objectives
+- Decision Trees and Random Forests on housing data.
+- Evaluate MAE, RMSE, and R2 score.

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-2/dataset/housing.csv

@@ -0,0 +1,5 @@
+area,bedrooms,price
+1200,2,250000
+1800,3,380000
+2400,4,520000
+850,1,160000

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-2/notebook.ipynb

@@ -0,0 +1,32 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "# PS-2: Decision Trees & Regression\n",
+        "\n",
+        "Jupyter Notebook for AIML Lab.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import pandas as pd\n",
+        "import numpy as np\n",
+        "df = pd.read_csv(\"dataset/housing.csv\")\n",
+        "df.head()\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-2/solution.py

@@ -0,0 +1,10 @@
+"""AIML Problem Sheet 2 (PS-2): Decision Trees & Regression"""
+import pandas as pd
+from pathlib import Path
+
+def main():
+    df = pd.read_csv(Path(__file__).parent / "dataset" / "housing.csv")
+    print("PS-2 Housing dataset loaded:", df.shape)
+
+if __name__ == "__main__":
+    main()

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-3/README.md

@@ -0,0 +1,5 @@
+# Problem Sheet 3 (PS-3)
+
+## Objectives
+- Clustering (K-Means) and Classification on Iris dataset.
+- Dimensionality Reduction with PCA.

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-3/dataset/iris.csv

@@ -0,0 +1,4 @@
+sepal_length,sepal_width,petal_length,petal_width,species
+5.1,3.5,1.4,0.2,setosa
+7.0,3.2,4.7,1.4,versicolor
+6.3,3.3,6.0,2.5,virginica

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-3/notebook.ipynb

@@ -0,0 +1,32 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "# PS-3: Clustering & PCA\n",
+        "\n",
+        "Jupyter Notebook for AIML Lab.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import pandas as pd\n",
+        "import numpy as np\n",
+        "df = pd.read_csv(\"dataset/iris.csv\")\n",
+        "df.head()\n"
+      ]
+    }
+  ],
+  "metadata": {
+    "language_info": {
+      "name": "python"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

heroalgorithm-0.1.0/src/heroalgorithm/assignments/PS-3/solution.py

@@ -0,0 +1,10 @@
+"""AIML Problem Sheet 3 (PS-3): Neural Networks / Clustering"""
+import pandas as pd
+from pathlib import Path
+
+def main():
+    df = pd.read_csv(Path(__file__).parent / "dataset" / "iris.csv")
+    print("PS-3 Iris dataset loaded:", df.shape)
+
+if __name__ == "__main__":
+    main()

heroalgorithm-0.1.0/src/heroalgorithm/assignments/README.md

@@ -0,0 +1,28 @@
+# 🤖 AI / ML Lab Assignments Repository
+
+This repository hosts all AI & Machine Learning lab problem sheets and code.
+
+Each problem sheet follows a consistent structure:
+```text
+PS-X/
+├── dataset/
+│   └── dataset.csv
+├── psX_notebook.ipynb
+├── psX_solution.py
+└── README.md
+```
+
+## Quick Download with AssignVault
+Students can download and organize everything locally with a single terminal command:
+
+```bash
+# 1. Download all Problem Sheets
+assignvault download
+
+# 2. Or download a specific Problem Sheet (e.g. PS-1)
+assignvault download ps-1
+# or: assignvault download 1
+
+# 3. List all available problem sheets
+assignvault list
+```