mlx-cv 0.0.1__tar.gz

mlx_cv-0.0.1/.github/workflows/workflow.yml

@@ -0,0 +1,60 @@
+name: Publish to PyPI
+
+# Trusted publishing (OIDC) — no API tokens.
+# Matches the PyPI publisher config: repo appautomaton/mlx-cv,
+# workflow file workflow.yml, environment "pypi".
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Check distribution metadata
+        run: |
+          python -m pip install --upgrade twine
+          python -m twine check dist/*
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/mlx-cv/
+    permissions:
+      id-token: write  # required for trusted publishing
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

mlx_cv-0.0.1/.gitignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Tooling caches
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.tox/
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store

mlx_cv-0.0.1/LICENSE

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

mlx_cv-0.0.1/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: mlx-cv
+Version: 0.0.1
+Summary: MLX-native computer vision for Apple Silicon: object detection, segmentation, and open-vocabulary grounding.
+Project-URL: Homepage, https://github.com/appautomaton/mlx-cv
+Project-URL: Repository, https://github.com/appautomaton/mlx-cv
+Project-URL: Issues, https://github.com/appautomaton/mlx-cv/issues
+Author-email: AppAutomaton <brian@bhoneycutt.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: apple-silicon,computer-vision,locate-anything,mlx,object-detection,open-vocabulary,sam,segmentation
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+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 :: Scientific/Engineering :: Image Recognition
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# mlx-cv
+
+**MLX-native computer vision for Apple Silicon** — object detection, segmentation, and open-vocabulary grounding.
+
+[![PyPI](https://img.shields.io/pypi/v/mlx-cv.svg)](https://pypi.org/project/mlx-cv/)
+[![Python](https://img.shields.io/pypi/pyversions/mlx-cv.svg)](https://pypi.org/project/mlx-cv/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+> ⚠️ **Pre-alpha / placeholder.** This release reserves the package name. The public API is not yet defined and will change without notice.
+
+## What is this?
+
+`mlx-cv` aims to be the detection & segmentation layer for the [MLX](https://github.com/ml-explore/mlx) ecosystem — sitting alongside `mlx-lm` and `mlx-vlm`, but focused on computer-vision tasks that run natively and efficiently on Apple Silicon.
+
+### Planned model support
+
+- **SAM 3** — promptable segmentation
+- **LocateAnything** — open-vocabulary detection / localization
+- …and more detection / grounding architectures over time
+
+## Installation
+
+```bash
+pip install mlx-cv
+```
+
+> Requires Python 3.9+ and an Apple Silicon Mac (for the eventual MLX runtime).
+
+## Status
+
+| Stage | Status |
+|-------|--------|
+| Name reserved on PyPI | ✅ |
+| Public API | 🚧 in design |
+| First model port | 🚧 planned |
+
+## License
+
+[MIT](LICENSE) © AppAutomaton

mlx_cv-0.0.1/README.md

@@ -0,0 +1,39 @@
+# mlx-cv
+
+**MLX-native computer vision for Apple Silicon** — object detection, segmentation, and open-vocabulary grounding.
+
+[![PyPI](https://img.shields.io/pypi/v/mlx-cv.svg)](https://pypi.org/project/mlx-cv/)
+[![Python](https://img.shields.io/pypi/pyversions/mlx-cv.svg)](https://pypi.org/project/mlx-cv/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+> ⚠️ **Pre-alpha / placeholder.** This release reserves the package name. The public API is not yet defined and will change without notice.
+
+## What is this?
+
+`mlx-cv` aims to be the detection & segmentation layer for the [MLX](https://github.com/ml-explore/mlx) ecosystem — sitting alongside `mlx-lm` and `mlx-vlm`, but focused on computer-vision tasks that run natively and efficiently on Apple Silicon.
+
+### Planned model support
+
+- **SAM 3** — promptable segmentation
+- **LocateAnything** — open-vocabulary detection / localization
+- …and more detection / grounding architectures over time
+
+## Installation
+
+```bash
+pip install mlx-cv
+```
+
+> Requires Python 3.9+ and an Apple Silicon Mac (for the eventual MLX runtime).
+
+## Status
+
+| Stage | Status |
+|-------|--------|
+| Name reserved on PyPI | ✅ |
+| Public API | 🚧 in design |
+| First model port | 🚧 planned |
+
+## License
+
+[MIT](LICENSE) © AppAutomaton

mlx_cv-0.0.1/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mlx-cv"
+version = "0.0.1"
+description = "MLX-native computer vision for Apple Silicon: object detection, segmentation, and open-vocabulary grounding."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "AppAutomaton", email = "brian@bhoneycutt.com" }]
+keywords = [
+    "mlx",
+    "computer-vision",
+    "object-detection",
+    "segmentation",
+    "open-vocabulary",
+    "apple-silicon",
+    "sam",
+    "locate-anything",
+]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "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 :: Scientific/Engineering :: Image Recognition",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/appautomaton/mlx-cv"
+Repository = "https://github.com/appautomaton/mlx-cv"
+Issues = "https://github.com/appautomaton/mlx-cv/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mlx_cv"]

mlx_cv-0.0.1/src/mlx_cv/__init__.py

@@ -0,0 +1,15 @@
+"""mlx-cv: MLX-native computer vision for Apple Silicon.
+
+This is a placeholder release that reserves the package name on PyPI.
+
+Planned scope: object detection, segmentation, and open-vocabulary
+grounding models running natively on Apple's MLX framework — including
+ports of models such as SAM 3 and LocateAnything.
+
+Status: pre-alpha (planning). The public API is not yet defined and
+will change without notice.
+"""
+
+__version__ = "0.0.1"
+
+__all__ = ["__version__"]