modelmri 0.0.1a0__tar.gz

modelmri-0.0.1a0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  backend:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: Lint, format, test
+        run: |
+          uv sync --dev
+          uv run ruff check .
+          uv run ruff format --check .
+          uv run pytest -q || [ $? -eq 5 ]   # exit 5 = no tests collected; OK pre-v0.1
+
+  frontend:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Lint & build (skips until frontend exists)
+        run: |
+          if [ -f frontend/package.json ]; then
+            cd frontend
+            npm ci
+            npm run lint --if-present
+            npm run build --if-present
+          else
+            echo "Frontend not scaffolded yet — skipping."
+          fi

modelmri-0.0.1a0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+uv.lock
+
+# Node
+node_modules/
+frontend/dist/
+.vite/
+
+# ModelMRI runtime data
+*.mri
+activations/
+*.zarr/
+sessions.sqlite*
+
+# Models & weights — never commit
+*.safetensors
+*.gguf
+*.ckpt
+*.pt
+*.pth
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+*.log
+
+# Secrets
+.env
+.env.*
+*.token

modelmri-0.0.1a0/LICENSE

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

modelmri-0.0.1a0/LOG.md

@@ -0,0 +1,7 @@
+# Working log
+
+## 2026-07-08 — Week 0
+- Name decided: **ModelMRI** ("an MRI machine for AI models"). Verified free on PyPI + npm.
+- Repo created, skeleton committed: README with public roadmap, MIT license, CI (ruff + pytest + frontend build), Python package stub, npm stub.
+- Dev environment confirmed: Python 3.12, uv, node 26, WSL2, RTX 4060.
+- Next: publish name-reserving stubs to PyPI + npm, Substack setup, essay #1, Day-1 X post.

modelmri-0.0.1a0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: modelmri
+Version: 0.0.1a0
+Summary: Chrome DevTools for AI models and agents — see attention, features, and agent steps inside any local model. Placeholder release; v0.1 in active development.
+Project-URL: Homepage, https://github.com/muhammadmahadazher/ModelMRI
+Project-URL: Repository, https://github.com/muhammadmahadazher/ModelMRI
+Author-email: Muhammad Mahad Azher <mahadazher@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: agents,debugging,devtools,interpretability,llm,sparse-autoencoder
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# ModelMRI
+
+**Chrome DevTools for AI models and agents.** Load any local model — LLM, VLM, or robot policy — and see inside it while it runs: attention, features, circuits, agent steps. Local-first. MIT.
+
+> 🚧 **Under active construction, in public.** v0.1 (live attention playground) ships in ~2 weeks.
+> Follow the build: [Substack](https://modelmri.substack.com)
+
+## Why
+
+When a model gives a wrong answer, you can't see why. When an agent fails at step 47, you get a wall of logs. When a robot policy drops the object, you get nothing. The research tools that *can* see inside (SAEs, attention analysis, circuit tracing) live in notebooks only specialists can drive.
+
+ModelMRI packages that research into a tool with the ergonomics of browser DevTools: one-line install, open `localhost:5900`, look inside.
+
+## Planned (the 12-week public roadmap)
+
+- **v0.1** — load a HuggingFace LLM, watch attention flow live at 60fps (WebGL)
+- **v0.2** — SAE feature browser: see the *concepts* inside the model, steer them
+- **v0.3** — agent mode: record any Anthropic-SDK/Claude-Code agent run, replay it, find the failing step
+- **v0.4** — the first interactive tool for looking inside a robot policy (SmolVLA + LeRobot)
+- **v0.5** — polish, zero-install hosted demo, launch
+
+## Status
+
+| Piece | State |
+|---|---|
+| Backend (FastAPI, activation hooks) | 🏗️ in progress |
+| Frontend (React + WebGL) | 🏗️ in progress |
+| `pip install modelmri` | placeholder published |
+
+MIT © Muhammad Mahad Azher

modelmri-0.0.1a0/README.md

@@ -0,0 +1,30 @@
+# ModelMRI
+
+**Chrome DevTools for AI models and agents.** Load any local model — LLM, VLM, or robot policy — and see inside it while it runs: attention, features, circuits, agent steps. Local-first. MIT.
+
+> 🚧 **Under active construction, in public.** v0.1 (live attention playground) ships in ~2 weeks.
+> Follow the build: [Substack](https://modelmri.substack.com)
+
+## Why
+
+When a model gives a wrong answer, you can't see why. When an agent fails at step 47, you get a wall of logs. When a robot policy drops the object, you get nothing. The research tools that *can* see inside (SAEs, attention analysis, circuit tracing) live in notebooks only specialists can drive.
+
+ModelMRI packages that research into a tool with the ergonomics of browser DevTools: one-line install, open `localhost:5900`, look inside.
+
+## Planned (the 12-week public roadmap)
+
+- **v0.1** — load a HuggingFace LLM, watch attention flow live at 60fps (WebGL)
+- **v0.2** — SAE feature browser: see the *concepts* inside the model, steer them
+- **v0.3** — agent mode: record any Anthropic-SDK/Claude-Code agent run, replay it, find the failing step
+- **v0.4** — the first interactive tool for looking inside a robot policy (SmolVLA + LeRobot)
+- **v0.5** — polish, zero-install hosted demo, launch
+
+## Status
+
+| Piece | State |
+|---|---|
+| Backend (FastAPI, activation hooks) | 🏗️ in progress |
+| Frontend (React + WebGL) | 🏗️ in progress |
+| `pip install modelmri` | placeholder published |
+
+MIT © Muhammad Mahad Azher

modelmri-0.0.1a0/modelmri/__init__.py

@@ -0,0 +1,14 @@
+"""ModelMRI — Chrome DevTools for AI models and agents.
+
+This is a placeholder release reserving the package name.
+v0.1 (live attention playground for local HuggingFace models)
+is in active development, in public:
+
+    https://github.com/muhammadmahadazher/ModelMRI
+"""
+
+__version__ = "0.0.1a0"
+
+
+def main() -> None:
+    print(__doc__)

modelmri-0.0.1a0/npm-stub/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+console.log(
+  "ModelMRI — Chrome DevTools for AI models and agents.\n" +
+  "This is a placeholder reserving the package name.\n" +
+  "v0.1 is in active development, in public:\n" +
+  "  https://github.com/muhammadmahadazher/ModelMRI\n"
+);

modelmri-0.0.1a0/npm-stub/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "modelmri",
+  "version": "0.0.1",
+  "description": "Chrome DevTools for AI models and agents — placeholder while v0.1 is built in public. See https://github.com/muhammadmahadazher/ModelMRI",
+  "keywords": ["interpretability", "llm", "agents", "debugging", "devtools"],
+  "license": "MIT",
+  "author": "Muhammad Mahad Azher",
+  "repository": { "type": "git", "url": "https://github.com/muhammadmahadazher/ModelMRI" },
+  "bin": { "modelmri": "./cli.js" }
+}

modelmri-0.0.1a0/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "modelmri"
+version = "0.0.1a0"
+description = "Chrome DevTools for AI models and agents — see attention, features, and agent steps inside any local model. Placeholder release; v0.1 in active development."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Muhammad Mahad Azher", email = "mahadazher@gmail.com" }]
+keywords = ["interpretability", "llm", "agents", "debugging", "devtools", "sparse-autoencoder"]
+classifiers = [
+  "Development Status :: 1 - Planning",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+]
+
+[project.urls]
+Homepage = "https://github.com/muhammadmahadazher/ModelMRI"
+Repository = "https://github.com/muhammadmahadazher/ModelMRI"
+
+[project.scripts]
+modelmri = "modelmri:main"
+
+[dependency-groups]
+dev = ["ruff>=0.8", "pytest>=8"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"