pulseml 0.2.2__tar.gz → 0.2.4__tar.gz

{pulseml-0.2.2 → pulseml-0.2.4}/LICENSE

@@ -1,49 +1,49 @@
-PULSE PROPRIETARY SOFTWARE LICENSE
-
-Copyright (c) 2026 Yash Patel. All Rights Reserved.
-
-This software and associated files (the "Software") are the proprietary
-property of the copyright holder. The Software is licensed, not sold.
-
-1. GRANT OF LICENSE
-   Subject to the terms of this license, the copyright holder grants you a
-   limited, non-exclusive, non-transferable, revocable license to install
-   and run the Software for your own internal use.
-
-2. RESTRICTIONS
-   Except as expressly permitted above, you may NOT, and may not permit
-   others to:
-   (a) copy, reproduce, distribute, sublicense, rent, lease, or resell the
-       Software;
-   (b) modify, adapt, translate, or create derivative works based on the
-       Software;
-   (c) reverse engineer, decompile, disassemble, or otherwise attempt to
-       derive the source code of the Software, except to the extent this
-       restriction is prohibited by applicable law;
-   (d) remove, obscure, or alter any proprietary notices on the Software;
-   (e) use the Software to build a competing product or service.
-
-3. FUTURE PAID TERMS
-   The copyright holder reserves the right to change pricing, introduce
-   paid tiers or license keys, limit functionality, or discontinue free
-   distribution of future versions at any time. Continued use of any
-   future version may be subject to additional terms, including payment.
-
-4. NO WARRANTY
-   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.
-
-5. LIMITATION OF LIABILITY
-   IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM,
-   DAMAGES, OR OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION
-   WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-6. TERMINATION
-   This license is effective until terminated. It will terminate
-   automatically without notice if you fail to comply with any of its
-   terms. Upon termination, you must cease all use of the Software and
-   destroy all copies in your possession.
-
-For licensing inquiries, contact: codeyash09@gmail.com
+PULSE PROPRIETARY SOFTWARE LICENSE
+
+Copyright (c) 2026 Yash Patel. All Rights Reserved.
+
+This software and associated files (the "Software") are the proprietary
+property of the copyright holder. The Software is licensed, not sold.
+
+1. GRANT OF LICENSE
+   Subject to the terms of this license, the copyright holder grants you a
+   limited, non-exclusive, non-transferable, revocable license to install
+   and run the Software for your own internal use.
+
+2. RESTRICTIONS
+   Except as expressly permitted above, you may NOT, and may not permit
+   others to:
+   (a) copy, reproduce, distribute, sublicense, rent, lease, or resell the
+       Software;
+   (b) modify, adapt, translate, or create derivative works based on the
+       Software;
+   (c) reverse engineer, decompile, disassemble, or otherwise attempt to
+       derive the source code of the Software, except to the extent this
+       restriction is prohibited by applicable law;
+   (d) remove, obscure, or alter any proprietary notices on the Software;
+   (e) use the Software to build a competing product or service.
+
+3. FUTURE PAID TERMS
+   The copyright holder reserves the right to change pricing, introduce
+   paid tiers or license keys, limit functionality, or discontinue free
+   distribution of future versions at any time. Continued use of any
+   future version may be subject to additional terms, including payment.
+
+4. NO WARRANTY
+   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.
+
+5. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM,
+   DAMAGES, OR OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION
+   WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+6. TERMINATION
+   This license is effective until terminated. It will terminate
+   automatically without notice if you fail to comply with any of its
+   terms. Upon termination, you must cease all use of the Software and
+   destroy all copies in your possession.
+
+For licensing inquiries, contact: codeyash09@gmail.com

pulseml-0.2.4/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: pulseml
+Version: 0.2.4
+Summary: A live ML training debugger for tracking, diagnosing, verifying, and patching training runs.
+Author-email: Yash Patel <codeyash09@gmail.com>
+License: Proprietary
+Project-URL: Homepage, https://pulsedb.netlify.app/
+Project-URL: Repository, https://github.com/codeyash09/PulseML
+Project-URL: Issues, https://github.com/codeyash09/PulseML/issues
+Project-URL: Documentation, https://pulsedb.netlify.app/
+Keywords: machine-learning,deep-learning,debugging,ml-debugging,training,pytorch,tensorflow,numpy,cupy,jax,gradients,training-debugger
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+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: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Debuggers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Requires-Dist: pillow
+Requires-Dist: litellm
+Requires-Dist: fpdf2
+Provides-Extra: torch
+Requires-Dist: torch; extra == "torch"
+Provides-Extra: tensorflow
+Requires-Dist: tensorflow; extra == "tensorflow"
+Provides-Extra: cupy
+Requires-Dist: cupy-cuda12x; extra == "cupy"
+Provides-Extra: jax
+Requires-Dist: jax; extra == "jax"
+Dynamic: license-file
+
+# PulseML
+
+**Pulse** — a live ML training debugger, GUI or CLI, any backend.
+
+🔗 [pulsedb.netlify.app](https://pulsedb.netlify.app/)
+
+Pulse is a live machine learning training debugger designed to monitor
+tensors, track metrics, visualize heatmaps and line charts, and interact
+with an integrated AI analyst.
+
+## Key Features
+
+- **GUI Mode** — Opens an interactive matrix picker with live shapes,
+  followed by a live dashboard with a heatmap grid and an integrated AI
+  chat panel.
+- **Smart Scalars** — Scalars (loss, accuracy, learning rate)
+  automatically render as live step-charts rather than heatmaps.
+  Loss-like scalars are auto-detected and pre-selected in the picker.
+- **CLI Mode** — Built for Colab, SSH, or headless environments, printing
+  tensor stats step-by-step, displaying live ASCII charts for scalars,
+  and supporting optional labeled PDF snapshots. Supports pausing
+  training so you can tag new matrices or ask the AI to interpret
+  results, right from the terminal.
+- **Universal Backend Support** — Automatically detects and works with
+  NumPy, PyTorch, TensorFlow, CuPy, and JAX via a shared backend
+  abstraction layer.
+- **High Performance** — Keeps overhead low by converting tensors to
+  host-side NumPy arrays, reusing Matplotlib figures (`set_data`) instead
+  of rebuilding them every step, and matching render sizes to the actual
+  on-screen thumbnail.
+- **Pulse AI Analyst** — A context-aware chat panel briefed on its role
+  that can inspect live matrix statistics, heatmaps, and your training
+  code when "Send Code" is enabled.
+
+## Past Debugs
+
+- Debugged a custom LLM after a vocab size increase (2.5x) by catching a
+  normalization bug — dividing residual growth by `math.sqrt(num_layers)`
+  instead of `num_layers` — that let activations blow up and halted
+  training.
+- Debugged another developer's custom attention mechanism producing NaN
+  loss, tracing it to a missing infinity check before a division.
+
+See [pulsedb.netlify.app](https://pulsedb.netlify.app/) for screenshots
+of matrix selection, the live dashboard, and the CLI view.
+
+## Install
+
+```bash
+pip install pulseml
+```
+
+`tkinter` is required for GUI mode and ships with most Python installs.
+On Debian/Ubuntu, if it's missing:
+
+```bash
+sudo apt install python3-tk
+```
+
+For CLI-mode PDF snapshots, `fpdf2` is installed automatically as part of
+the base package.
+
+## Quickstart
+
+Import `auto_track` and call it right before your training loop starts.
+Make sure your loop is wrapped in `if __name__ == '__main__':`.
+
+```python
+from pulse import auto_track
+
+if __name__ == '__main__':
+    auto_track()   # pass your training function for shape discovery, or call directly
+
+    # Your training loop
+    for epoch in range(num_epochs):
+        # Training logic here
+        pass
+```
+
+## AI Chat & API Keys
+
+To enable the AI chat panel, set the relevant provider's API key as an
+environment variable (e.g. `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`,
+`GEMINI_API_KEY`, `DEEPSEEK_API_KEY`) — or leave it unset and Pulse will
+prompt you for one inside the GUI the first time you send a message.
+
+## License
+
+Proprietary. See `LICENSE`. Use of this software is governed by the
+terms in that file — copying, redistribution, and reverse engineering
+are not permitted.

pulseml-0.2.4/README.md

@@ -0,0 +1,91 @@
+# PulseML
+
+**Pulse** — a live ML training debugger, GUI or CLI, any backend.
+
+🔗 [pulsedb.netlify.app](https://pulsedb.netlify.app/)
+
+Pulse is a live machine learning training debugger designed to monitor
+tensors, track metrics, visualize heatmaps and line charts, and interact
+with an integrated AI analyst.
+
+## Key Features
+
+- **GUI Mode** — Opens an interactive matrix picker with live shapes,
+  followed by a live dashboard with a heatmap grid and an integrated AI
+  chat panel.
+- **Smart Scalars** — Scalars (loss, accuracy, learning rate)
+  automatically render as live step-charts rather than heatmaps.
+  Loss-like scalars are auto-detected and pre-selected in the picker.
+- **CLI Mode** — Built for Colab, SSH, or headless environments, printing
+  tensor stats step-by-step, displaying live ASCII charts for scalars,
+  and supporting optional labeled PDF snapshots. Supports pausing
+  training so you can tag new matrices or ask the AI to interpret
+  results, right from the terminal.
+- **Universal Backend Support** — Automatically detects and works with
+  NumPy, PyTorch, TensorFlow, CuPy, and JAX via a shared backend
+  abstraction layer.
+- **High Performance** — Keeps overhead low by converting tensors to
+  host-side NumPy arrays, reusing Matplotlib figures (`set_data`) instead
+  of rebuilding them every step, and matching render sizes to the actual
+  on-screen thumbnail.
+- **Pulse AI Analyst** — A context-aware chat panel briefed on its role
+  that can inspect live matrix statistics, heatmaps, and your training
+  code when "Send Code" is enabled.
+
+## Past Debugs
+
+- Debugged a custom LLM after a vocab size increase (2.5x) by catching a
+  normalization bug — dividing residual growth by `math.sqrt(num_layers)`
+  instead of `num_layers` — that let activations blow up and halted
+  training.
+- Debugged another developer's custom attention mechanism producing NaN
+  loss, tracing it to a missing infinity check before a division.
+
+See [pulsedb.netlify.app](https://pulsedb.netlify.app/) for screenshots
+of matrix selection, the live dashboard, and the CLI view.
+
+## Install
+
+```bash
+pip install pulseml
+```
+
+`tkinter` is required for GUI mode and ships with most Python installs.
+On Debian/Ubuntu, if it's missing:
+
+```bash
+sudo apt install python3-tk
+```
+
+For CLI-mode PDF snapshots, `fpdf2` is installed automatically as part of
+the base package.
+
+## Quickstart
+
+Import `auto_track` and call it right before your training loop starts.
+Make sure your loop is wrapped in `if __name__ == '__main__':`.
+
+```python
+from pulse import auto_track
+
+if __name__ == '__main__':
+    auto_track()   # pass your training function for shape discovery, or call directly
+
+    # Your training loop
+    for epoch in range(num_epochs):
+        # Training logic here
+        pass
+```
+
+## AI Chat & API Keys
+
+To enable the AI chat panel, set the relevant provider's API key as an
+environment variable (e.g. `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`,
+`GEMINI_API_KEY`, `DEEPSEEK_API_KEY`) — or leave it unset and Pulse will
+prompt you for one inside the GUI the first time you send a message.
+
+## License
+
+Proprietary. See `LICENSE`. Use of this software is governed by the
+terms in that file — copying, redistribution, and reverse engineering
+are not permitted.

pulseml-0.2.4/pyproject.toml

@@ -0,0 +1,86 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pulseml"
+version = "0.2.4"
+description = "A live ML training debugger for tracking, diagnosing, verifying, and patching training runs."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Proprietary" }
+
+
+
+authors = [
+    { name = "Yash Patel", email = "codeyash09@gmail.com" }
+]
+
+keywords = [
+    "machine-learning",
+    "deep-learning",
+    "debugging",
+    "ml-debugging",
+    "training",
+    "pytorch",
+    "tensorflow",
+    "numpy",
+    "cupy",
+    "jax",
+    "gradients",
+    "training-debugger"
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: Other/Proprietary License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "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 :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Debuggers",
+]
+
+dependencies = [
+    "numpy",
+    "matplotlib",
+    "pillow",
+    "litellm",
+    "fpdf2",
+]
+
+[project.scripts]
+pulse = "pulse.cli:main"
+
+[project.optional-dependencies]
+torch = [
+    "torch"
+]
+
+tensorflow = [
+    "tensorflow"
+]
+
+cupy = [
+    "cupy-cuda12x"
+]
+
+jax = [
+    "jax"
+]
+
+[project.urls]
+Homepage = "https://pulsedb.netlify.app/"
+Repository = "https://github.com/codeyash09/PulseML"
+Issues = "https://github.com/codeyash09/PulseML/issues"
+Documentation = "https://pulsedb.netlify.app/"
+
+[tool.setuptools.packages.find]
+where = ["src"]