ai-practical-kit 1.1.0__tar.gz

ai_practical_kit-1.1.0/INSTALL_OFFLINE.bat

@@ -0,0 +1,27 @@
+@echo off
+setlocal
+set "WHEEL=%~dp0dist\ai_practical_kit-1.1.0-py3-none-any.whl"
+if not exist "%WHEEL%" (
+  echo ERROR: Wheel not found:
+  echo %WHEEL%
+  echo Please extract the complete AIPracticalKit offline ZIP first.
+  pause
+  exit /b 1
+)
+where py >nul 2>nul
+if %errorlevel%==0 (
+  py -m pip install --no-index --no-deps --upgrade "%WHEEL%"
+) else (
+  python -m pip install --no-index --no-deps --upgrade "%WHEEL%"
+)
+if %errorlevel% neq 0 (
+  echo.
+  echo Installation failed. Check that Python and pip are installed.
+  pause
+  exit /b 1
+)
+echo.
+echo AIPracticalKit installed successfully into this Python environment.
+echo For VS Code, select the same Python interpreter in the status bar.
+echo Launch GUI with: ai-practical-kit-gui
+pause

ai_practical_kit-1.1.0/INSTALL_OFFLINE.ps1

@@ -0,0 +1,12 @@
+$ErrorActionPreference = 'Stop'
+$wheel = Join-Path $PSScriptRoot 'dist\ai_practical_kit-1.1.0-py3-none-any.whl'
+if (-not (Test-Path $wheel)) {
+    throw "Wheel not found: $wheel. Extract the complete offline ZIP first."
+}
+$py = Get-Command py -ErrorAction SilentlyContinue
+if ($py) {
+    & py -m pip install --no-index --no-deps --upgrade $wheel
+} else {
+    & python -m pip install --no-index --no-deps --upgrade $wheel
+}
+Write-Host 'AIPracticalKit installed. Select this Python interpreter in VS Code.'

ai_practical_kit-1.1.0/INSTALL_OFFLINE.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+set -eu
+WHEEL="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)/dist/ai_practical_kit-1.1.0-py3-none-any.whl"
+if command -v python3 >/dev/null 2>&1; then
+  python3 -m pip install --no-index --no-deps --upgrade "$WHEEL"
+else
+  python -m pip install --no-index --no-deps --upgrade "$WHEEL"
+fi
+printf '\nAIPracticalKit installed. Select this Python interpreter in VS Code.\n'

ai_practical_kit-1.1.0/LICENSE

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

ai_practical_kit-1.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include README.md
+include LICENSE
+include PUBLISH_TO_PYPI.md
+include INSTALL_OFFLINE.bat
+include INSTALL_OFFLINE.ps1
+include INSTALL_OFFLINE.sh
+recursive-include tests *.py
+recursive-include examples *.py

ai_practical_kit-1.1.0/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: ai-practical-kit
+Version: 1.1.0
+Summary: Beginner-friendly Python implementations of 11 AI laboratory practical algorithms, with an offline source browser
+Author: AIPracticalKit contributors
+License-Expression: MIT
+Keywords: AI,practicals,education,search algorithms,backtracking,minimax
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# AIPracticalKit — Offline AI Laboratory Practical Library
+
+AIPracticalKit packages the 11 AI practicals as reusable Python functions and includes each complete `.py` implementation. It also provides a text menu and a desktop source browser so a student can run an experiment, inspect its code, copy it, or save a separate copy.
+
+**No third-party runtime dependencies. No internet is needed after you have downloaded the wheel or ZIP.** Python must already be installed on the computer. The graphical source browser uses Tkinter, which is included with most desktop Python installations.
+
+## Included experiments
+
+1. Simple Reflex Agent — Vacuum Cleaner World
+2. A* Search — 8-Puzzle using Manhattan distance
+3. Alpha-Beta Pruning — binary game tree
+4. Tower of Hanoi — BFS state-space search
+5. Sudoku — constraint propagation and backtracking
+6. Local Beam Search — Traveling Salesman Problem
+7. BFS — Robot Path Planning
+8. DFS — Maze Solving
+9. 8-Queens — backtracking and solution counting
+10. Rule-Based Chatbot — regular expressions, random responses and AND rule
+11. Tic-Tac-Toe — Minimax, demonstration mode and optional human-vs-AI mode
+
+## Recommended offline installation on Windows
+
+### Method A — install the wheel (works without internet)
+
+1. Extract the `AIPracticalKit_Offline_Install.zip` package.
+2. Open the extracted folder. It contains `dist/ai_practical_kit-1.1.0-py3-none-any.whl`.
+3. Double-click `INSTALL_OFFLINE.bat`, or open PowerShell in that folder and run:
+
+   ```powershell
+   py -m pip install --no-index --no-deps --upgrade .\dist\ai_practical_kit-1.1.0-py3-none-any.whl
+   ```
+
+   If the `py` launcher is unavailable, use `python -m pip` instead.
+4. In VS Code, select the same Python interpreter that you used for installation.
+5. Test the installation:
+
+   ```powershell
+   py -c "from ai_practical_kit import solve_astar; print(solve_astar('123406758')['moves'])"
+   ```
+
+   The expected number of moves is `2`.
+
+The wheel is pure Python and the project has no third-party runtime dependencies. `--no-index` tells pip not to contact a package index; `--no-deps` prevents dependency downloads.
+
+### Method B — use the source folder without installing
+
+Extract the full source ZIP, open the `AIPracticalKit` folder in VS Code, and run:
+
+```powershell
+py app.py
+```
+
+For a text menu, run:
+
+```powershell
+py run.py
+```
+
+This source-folder method also works offline and leaves the package uninstalled.
+
+## Open the source browser after installing the wheel
+
+After the wheel is installed, launch:
+
+```powershell
+ai-practical-kit-gui
+```
+
+Or run the module directly:
+
+```powershell
+py -m ai_practical_kit.gui
+```
+
+The GUI lets you select an experiment, view its entire source, run it, open its `.py` file in an editor, copy its source, or save a separate copy. If VS Code's `code` command is configured, the GUI opens the selected source in VS Code; otherwise, it uses a system text editor where available.
+
+For the terminal menu, use:
+
+```powershell
+ai-practical-kit
+```
+
+or:
+
+```powershell
+py -m ai_practical_kit.cli
+```
+
+## Import individual algorithms into your own file
+
+After installing the wheel, you can import the functions from any working directory using the same Python interpreter.
+
+### A* Search for 8-Puzzle
+
+```python
+from ai_practical_kit import solve_astar
+
+result = solve_astar("123406758")
+print("Found:", result["found"])
+print("Moves:", result["moves"])
+print("Path:", result["path"])
+```
+
+### 8-Queens
+
+```python
+from ai_practical_kit import solve_8_queens
+
+result = solve_8_queens()
+print("First solution:", result["solution"])
+print("Total solutions:", result["total_solutions"])
+```
+
+### Rule-based chatbot
+
+```python
+from ai_practical_kit import respond
+
+print(respond("hello"))
+print(respond("Tell me about admission and fees"))
+```
+
+### Other exported functions
+
+```python
+from ai_practical_kit import (
+    solve_vacuum,
+    solve_alpha_beta,
+    solve_hanoi_bfs,
+    solve_sudoku,
+    local_beam_tsp,
+    solve_robot_bfs,
+    solve_maze_dfs,
+    find_best_move,
+    minimax,
+)
+```
+
+Read `ai_practical_kit/experiments/` in the source ZIP or select an experiment in the source browser to see full implementations and exact inputs.
+
+## Test the package
+
+From the source project directory, run:
+
+```powershell
+py tests\smoke_test.py
+```
+
+Expected final line:
+
+```text
+All 11 AIPracticalKit smoke tests passed.
+```
+
+## Publishing to PyPI later (optional)
+
+Offline installation does not require PyPI. If you later decide to publish the package for public installation, use `PUBLISH_TO_PYPI.md`. Publishing requires internet access, a PyPI account, and a package name that is available. This project is built locally; it has **not** been uploaded to PyPI by this ZIP.
+
+## Notes
+
+- The package is designed for study and practical examinations, not as a highly optimized production solver.
+- A* validates the 8-puzzle state and checks parity before searching.
+- BFS finds a shortest path when every move has equal cost. DFS finds a path but does not guarantee the shortest one.
+- Local Beam Search is a heuristic and does not guarantee a globally optimal TSP tour.
+- Alpha-Beta Pruning and Minimax evaluate the supplied game tree or board.
+- Sudoku applies constraint propagation before recursive backtracking.
+- The package distribution name is `ai-practical-kit`; the import name is `ai_practical_kit`.

ai_practical_kit-1.1.0/PUBLISH_TO_PYPI.md

@@ -0,0 +1,86 @@
+# Publish AIPracticalKit to PyPI
+
+This project is packaged as `ai-practical-kit`; the Python import name is `ai_practical_kit`.
+
+## Recommended method: PyPI Trusted Publishing with GitHub Actions
+
+This method avoids storing a long-lived PyPI API token in GitHub. It requires a GitHub repository and an internet connection during publication.
+
+### 1. Create a GitHub repository
+
+Create a repository, for example `AIPracticalKit`, under your own GitHub account. Upload the **contents** of this project folder to the repository root (so `pyproject.toml` is at the root). Include `.github/workflows/publish.yml`.
+
+### 2. Create the GitHub environment
+
+In the GitHub repository, open **Settings → Environments**, create an environment named exactly `pypi`. The workflow uses this environment name.
+
+### 3. Register the pending publisher on PyPI
+
+Open https://pypi.org/manage/account/publishing/ and select **GitHub**. Enter:
+
+- **PyPI Project Name:** `ai-practical-kit`
+- **Owner:** your exact GitHub username or organization (not automatically your PyPI username)
+- **Repository name:** the exact repository name you created, e.g. `AIPracticalKit`
+- **Workflow name:** `publish.yml`
+- **Environment name:** `pypi`
+
+Click **Add**. This is a pending publisher: it does not reserve the package name until the first successful publishing workflow runs.
+
+### 4. Commit and push the workflow
+
+Confirm `.github/workflows/publish.yml` is at the repository root under `.github/workflows/` and that `pyproject.toml` is also at the repository root.
+
+### 5. Publish the first release
+
+The current package version is `1.1.0`. After the files are pushed, create a GitHub Release with tag `v1.1.0` and publish the release. That triggers the workflow to build the wheel and source archive, check them, and upload them to PyPI using Trusted Publishing.
+
+If the project name was claimed by someone else before the first upload, the workflow will fail. In that case, choose a new unique `project.name` in `pyproject.toml`, rebuild, and update the PyPI pending publisher to match before publishing.
+
+### 6. Verify
+
+After a successful workflow, check https://pypi.org/project/ai-practical-kit/ . Then, on a computer with internet, install it with:
+
+```powershell
+py -m pip install ai-practical-kit
+```
+
+Use it in Python with:
+
+```python
+from ai_practical_kit import solve_8_queens
+
+result = solve_8_queens()
+print(result["total_solutions"])
+```
+
+Expected total: `92`.
+
+## Alternative: manual upload with an API token
+
+You do not need to use the Trusted Publisher screen if you prefer to upload manually. Follow the current PyPI packaging guide: https://packaging.python.org/en/latest/tutorials/packaging-projects/
+
+From the project root, build and check the distributions:
+
+```powershell
+py -m pip install --upgrade build twine
+py -m build
+py -m twine check dist/*
+```
+
+Then create a PyPI API token in **Account settings → API tokens** and upload:
+
+```powershell
+py -m twine upload dist/*
+```
+
+When Twine prompts for credentials, use username `__token__` and paste the API token (including its `pypi-` prefix) as the password. Never put the token in source code or send it in chat. If the package does not yet exist, an account-scoped token may be required for the first upload; after creating the project, consider a project-scoped token and revoke the broader token.
+
+## Offline use
+
+PyPI publication does not make installation possible without internet on a new machine. For offline systems, copy the `.whl` file from `dist/` to the machine and install it locally:
+
+```powershell
+py -m pip install --no-index --no-deps .\dist\ai_practical_kit-1.1.0-py3-none-any.whl
+```
+
+The package itself has no third-party runtime dependencies. Python must already be installed on the computer.

ai_practical_kit-1.1.0/README.md

@@ -0,0 +1,167 @@
+# AIPracticalKit — Offline AI Laboratory Practical Library
+
+AIPracticalKit packages the 11 AI practicals as reusable Python functions and includes each complete `.py` implementation. It also provides a text menu and a desktop source browser so a student can run an experiment, inspect its code, copy it, or save a separate copy.
+
+**No third-party runtime dependencies. No internet is needed after you have downloaded the wheel or ZIP.** Python must already be installed on the computer. The graphical source browser uses Tkinter, which is included with most desktop Python installations.
+
+## Included experiments
+
+1. Simple Reflex Agent — Vacuum Cleaner World
+2. A* Search — 8-Puzzle using Manhattan distance
+3. Alpha-Beta Pruning — binary game tree
+4. Tower of Hanoi — BFS state-space search
+5. Sudoku — constraint propagation and backtracking
+6. Local Beam Search — Traveling Salesman Problem
+7. BFS — Robot Path Planning
+8. DFS — Maze Solving
+9. 8-Queens — backtracking and solution counting
+10. Rule-Based Chatbot — regular expressions, random responses and AND rule
+11. Tic-Tac-Toe — Minimax, demonstration mode and optional human-vs-AI mode
+
+## Recommended offline installation on Windows
+
+### Method A — install the wheel (works without internet)
+
+1. Extract the `AIPracticalKit_Offline_Install.zip` package.
+2. Open the extracted folder. It contains `dist/ai_practical_kit-1.1.0-py3-none-any.whl`.
+3. Double-click `INSTALL_OFFLINE.bat`, or open PowerShell in that folder and run:
+
+   ```powershell
+   py -m pip install --no-index --no-deps --upgrade .\dist\ai_practical_kit-1.1.0-py3-none-any.whl
+   ```
+
+   If the `py` launcher is unavailable, use `python -m pip` instead.
+4. In VS Code, select the same Python interpreter that you used for installation.
+5. Test the installation:
+
+   ```powershell
+   py -c "from ai_practical_kit import solve_astar; print(solve_astar('123406758')['moves'])"
+   ```
+
+   The expected number of moves is `2`.
+
+The wheel is pure Python and the project has no third-party runtime dependencies. `--no-index` tells pip not to contact a package index; `--no-deps` prevents dependency downloads.
+
+### Method B — use the source folder without installing
+
+Extract the full source ZIP, open the `AIPracticalKit` folder in VS Code, and run:
+
+```powershell
+py app.py
+```
+
+For a text menu, run:
+
+```powershell
+py run.py
+```
+
+This source-folder method also works offline and leaves the package uninstalled.
+
+## Open the source browser after installing the wheel
+
+After the wheel is installed, launch:
+
+```powershell
+ai-practical-kit-gui
+```
+
+Or run the module directly:
+
+```powershell
+py -m ai_practical_kit.gui
+```
+
+The GUI lets you select an experiment, view its entire source, run it, open its `.py` file in an editor, copy its source, or save a separate copy. If VS Code's `code` command is configured, the GUI opens the selected source in VS Code; otherwise, it uses a system text editor where available.
+
+For the terminal menu, use:
+
+```powershell
+ai-practical-kit
+```
+
+or:
+
+```powershell
+py -m ai_practical_kit.cli
+```
+
+## Import individual algorithms into your own file
+
+After installing the wheel, you can import the functions from any working directory using the same Python interpreter.
+
+### A* Search for 8-Puzzle
+
+```python
+from ai_practical_kit import solve_astar
+
+result = solve_astar("123406758")
+print("Found:", result["found"])
+print("Moves:", result["moves"])
+print("Path:", result["path"])
+```
+
+### 8-Queens
+
+```python
+from ai_practical_kit import solve_8_queens
+
+result = solve_8_queens()
+print("First solution:", result["solution"])
+print("Total solutions:", result["total_solutions"])
+```
+
+### Rule-based chatbot
+
+```python
+from ai_practical_kit import respond
+
+print(respond("hello"))
+print(respond("Tell me about admission and fees"))
+```
+
+### Other exported functions
+
+```python
+from ai_practical_kit import (
+    solve_vacuum,
+    solve_alpha_beta,
+    solve_hanoi_bfs,
+    solve_sudoku,
+    local_beam_tsp,
+    solve_robot_bfs,
+    solve_maze_dfs,
+    find_best_move,
+    minimax,
+)
+```
+
+Read `ai_practical_kit/experiments/` in the source ZIP or select an experiment in the source browser to see full implementations and exact inputs.
+
+## Test the package
+
+From the source project directory, run:
+
+```powershell
+py tests\smoke_test.py
+```
+
+Expected final line:
+
+```text
+All 11 AIPracticalKit smoke tests passed.
+```
+
+## Publishing to PyPI later (optional)
+
+Offline installation does not require PyPI. If you later decide to publish the package for public installation, use `PUBLISH_TO_PYPI.md`. Publishing requires internet access, a PyPI account, and a package name that is available. This project is built locally; it has **not** been uploaded to PyPI by this ZIP.
+
+## Notes
+
+- The package is designed for study and practical examinations, not as a highly optimized production solver.
+- A* validates the 8-puzzle state and checks parity before searching.
+- BFS finds a shortest path when every move has equal cost. DFS finds a path but does not guarantee the shortest one.
+- Local Beam Search is a heuristic and does not guarantee a globally optimal TSP tour.
+- Alpha-Beta Pruning and Minimax evaluate the supplied game tree or board.
+- Sudoku applies constraint propagation before recursive backtracking.
+- The package distribution name is `ai-practical-kit`; the import name is `ai_practical_kit`.

ai_practical_kit-1.1.0/ai_practical_kit/__init__.py

@@ -0,0 +1,22 @@
+"""AIPracticalKit: reusable, beginner-friendly AI practical algorithms."""
+
+from .experiments.vacuum_cleaner import solve_vacuum
+from .experiments.astar_8_puzzle import solve_astar, heuristic
+from .experiments.alpha_beta_pruning import solve_alpha_beta
+from .experiments.tower_of_hanoi_bfs import solve_hanoi_bfs
+from .experiments.sudoku_solver import solve_sudoku
+from .experiments.local_beam_tsp import local_beam_tsp, tour_cost
+from .experiments.robot_path_bfs import solve_robot_bfs
+from .experiments.maze_dfs import solve_maze_dfs
+from .experiments.eight_queens import solve_8_queens
+from .experiments.rule_chatbot import respond
+from .experiments.tictactoe_minimax import find_best_move, minimax
+
+__version__ = "1.1.0"
+
+__all__ = [
+    "solve_vacuum", "solve_astar", "heuristic", "solve_alpha_beta",
+    "solve_hanoi_bfs", "solve_sudoku", "local_beam_tsp", "tour_cost",
+    "solve_robot_bfs", "solve_maze_dfs", "solve_8_queens", "respond",
+    "find_best_move", "minimax",
+]