pulseml 0.1.0__tar.gz

pulseml-0.1.0/LICENSE

@@ -0,0 +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

pulseml-0.1.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: pulseml
+Version: 0.1.0
+Summary: A live ML training debugger - GUI or CLI, any backend (NumPy, PyTorch, TensorFlow, CuPy, JAX).
+Author-email: Yash Patel <codeyash09@gmail.com>
+License: Proprietary
+Project-URL: Homepage, https://github.com/codeyash09/PulseML
+Project-URL: Issues, https://github.com/codeyash09/PulseML/issues
+Keywords: machine-learning,deep-learning,debugging,pytorch,tensorflow,numpy,jax,cupy,training,visualization
+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: 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
+
+# Pulse
+
+A live ML training debugger - GUI or CLI, any backend.
+
+```python
+from pulse import auto_track
+if __name__ == "__main__":
+    auto_track()
+    #training function
+```
+
+**GUI mode** opens a matrix picker with live shapes, then a live dashboard:
+a heatmap grid on the left (click a tile to enlarge, right-click to
+reconfigure axes) and an AI chat panel on the right that's briefed on its
+role and can optionally see your training code. Scalars (loss, accuracy,
+lr - anything shape `()`) render as a live line chart instead of a heatmap.
+Loss-like scalars are auto-detected and pre-selected so you don't have to
+hunt for them every run.
+
+**CLI mode** is for Colab, SSH, or anywhere headless. No heatmaps are shown
+on screen - matrices/tensors are "tagged" as text (stats printed each
+step) and scalars get a live ASCII chart. You can optionally save labeled
+PDF snapshots per variable per step.
+
+**Backends:** NumPy, PyTorch, TensorFlow, CuPy, JAX - detected
+automatically. Pulse never checks for `torch`/`tf`/etc. directly; it only
+ever talks to its own backend-abstraction module.
+
+## Install
+
+```bash
+pip install pulse-ml
+```
+
+`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
+```
+
+To also track PyTorch, TensorFlow, CuPy, or JAX tensors, install the
+matching extra:
+
+```bash
+pip install "pulse-ml[torch]"
+pip install "pulse-ml[tensorflow]"
+pip install "pulse-ml[cupy]"
+pip install "pulse-ml[jax]"
+```
+
+## AI chat / analyst
+
+Set the relevant provider's API key as an environment variable (e.g.
+`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`) to enable the AI chat panel - or
+leave it unset and Pulse will prompt you for one 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.1.0/README.md

@@ -0,0 +1,63 @@
+# Pulse
+
+A live ML training debugger - GUI or CLI, any backend.
+
+```python
+from pulse import auto_track
+if __name__ == "__main__":
+    auto_track()
+    #training function
+```
+
+**GUI mode** opens a matrix picker with live shapes, then a live dashboard:
+a heatmap grid on the left (click a tile to enlarge, right-click to
+reconfigure axes) and an AI chat panel on the right that's briefed on its
+role and can optionally see your training code. Scalars (loss, accuracy,
+lr - anything shape `()`) render as a live line chart instead of a heatmap.
+Loss-like scalars are auto-detected and pre-selected so you don't have to
+hunt for them every run.
+
+**CLI mode** is for Colab, SSH, or anywhere headless. No heatmaps are shown
+on screen - matrices/tensors are "tagged" as text (stats printed each
+step) and scalars get a live ASCII chart. You can optionally save labeled
+PDF snapshots per variable per step.
+
+**Backends:** NumPy, PyTorch, TensorFlow, CuPy, JAX - detected
+automatically. Pulse never checks for `torch`/`tf`/etc. directly; it only
+ever talks to its own backend-abstraction module.
+
+## Install
+
+```bash
+pip install pulse-ml
+```
+
+`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
+```
+
+To also track PyTorch, TensorFlow, CuPy, or JAX tensors, install the
+matching extra:
+
+```bash
+pip install "pulse-ml[torch]"
+pip install "pulse-ml[tensorflow]"
+pip install "pulse-ml[cupy]"
+pip install "pulse-ml[jax]"
+```
+
+## AI chat / analyst
+
+Set the relevant provider's API key as an environment variable (e.g.
+`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`) to enable the AI chat panel - or
+leave it unset and Pulse will prompt you for one 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.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pulseml"
+version = "0.1.0"
+description = "A live ML training debugger - GUI or CLI, any backend (NumPy, PyTorch, TensorFlow, CuPy, JAX)."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Proprietary" }
+authors = [
+    { name = "Yash Patel", email = "codeyash09@gmail.com" }
+]
+keywords = [
+    "machine-learning", "deep-learning", "debugging", "pytorch",
+    "tensorflow", "numpy", "jax", "cupy", "training", "visualization"
+]
+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",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Debuggers",
+]
+dependencies = [
+    "numpy",
+    "matplotlib",
+    "pillow",
+    "litellm",
+    "fpdf2",
+]
+
+[project.optional-dependencies]
+torch = ["torch"]
+tensorflow = ["tensorflow"]
+cupy = ["cupy-cuda12x"]
+jax = ["jax"]
+
+[project.urls]
+Homepage = "https://github.com/codeyash09/PulseML"
+Issues = "https://github.com/codeyash09/PulseML/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

pulseml-0.1.0/setup.cfg

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

pulseml-0.1.0/src/pulse/__init__.py

@@ -0,0 +1,10 @@
+"""
+Pulse — a live ML training debugger, GUI or CLI, any backend.
+
+    from pulse import auto_track
+    auto_track(train_step)
+"""
+from .pulse import auto_track, shutdown
+
+__version__ = "0.1.0"
+__all__ = ["auto_track", "shutdown"]