Refactor package name from 'mata' to 'datamata' in all files

.github/workflows/publish.yml

@@ -6,6 +6,7 @@ on:
 jobs:
   publish:
     runs-on: ubuntu-latest
+    environment: pypi
     permissions:
       id-token: write
     steps:

CHANGELOG.md

@@ -13,6 +13,14 @@ Versions follow [Semantic Versioning](https://semver.org/).
 
 ## [1.9.2] Beta Release - 2026-03-09
 
+### Changed
+
+**PyPI Distribution Rename**
+
+- PyPI distribution name changed from `mata` to `datamata`; users now run `pip install datamata` to install
+- `import mata` is unchanged — all existing code continues to work without modification
+- Follows the PIL/Pillow precedent: distribution name and import name differ intentionally
+
 ### Added
 
 **Valkey / Redis Graph Pipeline Storage**
@@ -26,7 +34,7 @@ Versions follow [Semantic Versioning](https://semver.org/).
 - `valkey://` and `redis://` URI scheme dispatch added to all six `result.save()` methods (`VisionResult`, `DetectResult`, `SegmentResult`, `ClassifyResult`, `DepthResult`, `OCRResult`) — existing file-based paths are fully unaffected
 - `ModelRegistry.get_valkey_connection(name="default")` — reads named Valkey connection profiles from the `storage.valkey` section of `.mata/models.yaml` or `~/.mata/models.yaml`; resolves `password_env` from environment variables; raises `ModelNotFoundError` for unknown connection names
 - YAML `storage.valkey.<name>` config schema with `url`, `db`, `ttl`, `password_env`, and `tls` fields
-- Optional dependency groups: `pip install mata[valkey]` → `valkey>=6.0.0`; `pip install mata[redis]` → `redis>=5.0.0`; both added to the `dev` extras group
+- Optional dependency groups: `pip install datamata[valkey]` → `valkey>=6.0.0`; `pip install datamata[redis]` → `redis>=5.0.0`; both added to the `dev` extras group
 - `export_valkey`, `load_valkey`, and `publish_valkey` exported from `mata.core.exporters`
 - `ValkeyStore` and `ValkeyLoad` exported from `mata.nodes`
 - 89 new tests: 42 exporter tests (`test_valkey_exporter.py`), 33 graph node tests (`test_valkey_nodes.py`), 14 config and pub/sub tests (`test_valkey_config.py`)

QUICKSTART.md

@@ -373,8 +373,8 @@ Persist any MATA result to [Valkey](https://valkey.io/) or Redis for distributed
 ### Install
 
 ```bash
-pip install mata[valkey]   # valkey-py (recommended)
-pip install mata[redis]    # redis-py (alternative)
+pip install datamata[valkey]   # valkey-py (recommended)
+pip install datamata[redis]    # redis-py (alternative)
 ```
 
 ### Save and load a result

README.md

@@ -101,8 +101,8 @@ pip install onnxruntime-gpu  # GPU
 pip install matplotlib
 
 # For Valkey/Redis result storage
-pip install mata[valkey]   # valkey-py client (recommended)
-pip install mata[redis]    # redis-py client (alternative)
+pip install datamata[valkey]   # valkey-py client (recommended)
+pip install datamata[redis]    # redis-py client (alternative)
 ```
 
 ## 🚀 Quick Start

docs/CLIP_QUICK_START.md

@@ -37,7 +37,7 @@ print(result.predictions[0].label_name)  # "cat"
 ## Installation
 
 ```bash
-pip install mata transformers torch
+pip install datamata transformers torch
 ```
 
 **Requirements:**

docs/GRAPH_API_REFERENCE.md

@@ -872,8 +872,8 @@ from mata.nodes import ValkeyStore, ValkeyLoad
 **Installation:**
 
 ```bash
-pip install mata[valkey]   # valkey-py client
-pip install mata[redis]    # redis-py client (fallback)
+pip install datamata[valkey]   # valkey-py client
+pip install datamata[redis]    # redis-py client (fallback)
 ```
 
 Both nodes lazy-import the client library — `import mata` succeeds without either installed. An `ImportError` with an actionable message is raised only when a storage node actually executes.

docs/OCR_IMPLEMENTATION_SUMMARY.md

@@ -63,7 +63,7 @@ pip install transformers accelerate
 
 # EasyOCR
 pip install easyocr
-# or: pip install mata[ocr]
+# or: pip install datamata[ocr]
 
 # PaddleOCR — IMPORTANT: paddleocr and paddlepaddle MAJOR versions must match.
 # paddleocr 3.x requires paddlepaddle 3.x (mismatched installs cause native crashes).
@@ -75,11 +75,11 @@ pip install paddlepaddle-gpu==3.0.0 -i https://www.paddlepaddle.org.cn/packages/
 pip install paddlepaddle-gpu==3.0.0 -i https://www.paddlepaddle.org.cn/packages/stable/cu123/  # CUDA 12.3
 pip install paddlepaddle-gpu==3.0.0 -i https://www.paddlepaddle.org.cn/packages/stable/cu126/  # CUDA 12.6 (recommended)
 # Wheel is ~1–1.5 GB.  See https://www.paddlepaddle.org.cn/install/quick for all options.
-# or: pip install mata[ocr-paddle]  (installs CPU wheel only)
+# or: pip install datamata[ocr-paddle]  (installs CPU wheel only)
 
 # Tesseract
 pip install pytesseract
-# or: pip install mata[ocr-tesseract]
+# or: pip install datamata[ocr-tesseract]
 # + system binary:
 #   Ubuntu/Debian: sudo apt-get install tesseract-ocr
 #   macOS:         brew install tesseract