abstractvision 0.1.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

abstractvision-0.2.1.dist-info/METADATA

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: abstractvision
+Version: 0.2.1
+Summary: Model-agnostic generative vision abstractions (image/video) for the Abstract ecosystem
+Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
+License: MIT
+Project-URL: Homepage, https://github.com/abstractcore/abstractvision
+Project-URL: Repository, https://github.com/abstractcore/abstractvision
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Multimedia
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: diffusers>=0.36.0
+Requires-Dist: torch<3.0.0,>=2.0
+Requires-Dist: transformers<6.0.0,>=4.0
+Requires-Dist: accelerate>=0.0
+Requires-Dist: safetensors>=0.0
+Requires-Dist: sentencepiece>=0.1.99
+Requires-Dist: protobuf>=3.20.0
+Requires-Dist: einops>=0.7.0
+Requires-Dist: peft>=0.10.0
+Requires-Dist: Pillow>=9.0
+Requires-Dist: stable-diffusion-cpp-python>=0.4.2
+Provides-Extra: openai-compatible
+Provides-Extra: sdcpp
+Requires-Dist: stable-diffusion-cpp-python>=0.4.2; extra == "sdcpp"
+Provides-Extra: huggingface
+Requires-Dist: diffusers>=0.36.0; extra == "huggingface"
+Requires-Dist: torch>=2.0; extra == "huggingface"
+Requires-Dist: transformers>=4.0; extra == "huggingface"
+Requires-Dist: accelerate>=0.0; extra == "huggingface"
+Requires-Dist: safetensors>=0.0; extra == "huggingface"
+Requires-Dist: Pillow>=9.0; extra == "huggingface"
+Provides-Extra: local
+Requires-Dist: stable-diffusion-cpp-python>=0.4.2; extra == "local"
+Requires-Dist: diffusers>=0.36.0; extra == "local"
+Requires-Dist: torch>=2.0; extra == "local"
+Requires-Dist: transformers>=4.0; extra == "local"
+Requires-Dist: accelerate>=0.0; extra == "local"
+Requires-Dist: safetensors>=0.0; extra == "local"
+Requires-Dist: Pillow>=9.0; extra == "local"
+Provides-Extra: huggingface-dev
+Requires-Dist: diffusers>=0.36.0; extra == "huggingface-dev"
+Requires-Dist: torch>=2.0; extra == "huggingface-dev"
+Requires-Dist: transformers>=5.0; extra == "huggingface-dev"
+Requires-Dist: accelerate>=0.0; extra == "huggingface-dev"
+Requires-Dist: safetensors>=0.0; extra == "huggingface-dev"
+Requires-Dist: Pillow>=9.0; extra == "huggingface-dev"
+Provides-Extra: abstractcore
+Requires-Dist: abstractcore>=2.0.0; extra == "abstractcore"
+Dynamic: license-file
+
+# AbstractVision
+
+Model-agnostic generative vision API (images, optional video) for Python and the Abstract* ecosystem.
+
+## What you get
+
+- A stable task API: `VisionManager` (`src/abstractvision/vision_manager.py`)
+- A packaged capability registry (“what models can do”): `VisionModelCapabilitiesRegistry` backed by `src/abstractvision/assets/vision_model_capabilities.json`
+- Optional artifact-ref outputs (small JSON refs): `LocalAssetStore` / store adapters (`src/abstractvision/artifacts.py`)
+- Built-in backends (`src/abstractvision/backends/`):
+  - OpenAI-compatible HTTP (`openai_compatible.py`)
+  - Local Diffusers (`huggingface_diffusers.py`)
+  - Local stable-diffusion.cpp / GGUF (`stable_diffusion_cpp.py`)
+- CLI/REPL for manual testing: `abstractvision ...` (`src/abstractvision/cli.py`)
+
+## Status (current backend support)
+
+- Built-in backends implement: `text_to_image` and `image_to_image`.
+- Video (`text_to_video`, `image_to_video`) is supported only via the OpenAI-compatible backend **when** endpoints are configured.
+- `multi_view_image` is part of the public API (`VisionManager.generate_angles`) but no built-in backend implements it yet.
+
+Details: `docs/reference/backends.md`.
+
+## Installation
+
+```bash
+pip install abstractvision
+```
+
+Install optional integrations:
+
+```bash
+pip install "abstractvision[abstractcore]"
+```
+
+Some newer model pipelines may require Diffusers from GitHub `main` (see `docs/getting-started.md`):
+
+```bash
+pip install -U "abstractvision[huggingface-dev]"
+```
+
+For local dev (from a repo checkout):
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+Start here:
+- Getting started: `docs/getting-started.md`
+- FAQ: `docs/faq.md`
+- API reference: `docs/api.md`
+- Architecture: `docs/architecture.md`
+- Docs index: `docs/README.md`
+
+### Capability-driven model selection
+
+```python
+from abstractvision import VisionModelCapabilitiesRegistry
+
+reg = VisionModelCapabilitiesRegistry()
+assert reg.supports("Qwen/Qwen-Image-2512", "text_to_image")
+
+print(reg.list_tasks())
+print(reg.models_for_task("text_to_image"))
+```
+
+### Backend wiring + generation (artifact outputs)
+
+The default install is “batteries included” (Torch + Diffusers + stable-diffusion.cpp python bindings), but heavy
+modules are imported lazily (see `src/abstractvision/backends/__init__.py`).
+
+```python
+from abstractvision import LocalAssetStore, VisionManager, VisionModelCapabilitiesRegistry, is_artifact_ref
+from abstractvision.backends import OpenAICompatibleBackendConfig, OpenAICompatibleVisionBackend
+
+reg = VisionModelCapabilitiesRegistry()
+
+backend = OpenAICompatibleVisionBackend(
+    config=OpenAICompatibleBackendConfig(
+        base_url="http://localhost:1234/v1",
+        api_key="YOUR_KEY",      # optional for local servers
+        model_id="REMOTE_MODEL", # optional (server-dependent)
+    )
+)
+
+vm = VisionManager(
+    backend=backend,
+    store=LocalAssetStore(),         # enables artifact-ref outputs
+    model_id="zai-org/GLM-Image",    # optional: capability gating
+    registry=reg,                   # optional: reuse loaded registry
+)
+
+out = vm.generate_image("a cinematic photo of a red fox in snow")
+assert is_artifact_ref(out)
+print(out)  # {"$artifact": "...", "content_type": "...", ...}
+
+png_bytes = vm.store.load_bytes(out["$artifact"])  # type: ignore[union-attr]
+```
+
+### Interactive testing (CLI / REPL)
+
+```bash
+abstractvision models
+abstractvision tasks
+abstractvision show-model zai-org/GLM-Image
+
+abstractvision repl
+```
+
+Inside the REPL:
+
+```text
+/backend openai http://localhost:1234/v1
+/cap-model zai-org/GLM-Image
+/set width 1024
+/set height 1024
+/t2i "a watercolor painting of a lighthouse" --open
+```
+
+The CLI/REPL can also be configured via `ABSTRACTVISION_*` env vars; see `docs/reference/configuration.md`.
+
+One-shot commands (OpenAI-compatible HTTP backend only):
+
+```bash
+abstractvision t2i --base-url http://localhost:1234/v1 "a studio photo of an espresso machine"
+abstractvision i2i --base-url http://localhost:1234/v1 --image ./input.png "make it watercolor"
+```
+
+#### Local GGUF via stable-diffusion.cpp
+
+If you want to run GGUF diffusion models locally (e.g. Qwen Image), use the stable-diffusion.cpp backend (`sdcpp`).
+
+Recommended (pip-only; no external binary download): `pip install abstractvision` already includes the stable-diffusion.cpp python bindings (`stable-diffusion-cpp-python`).
+
+Alternative (external executable):
+
+- Install `sd-cli`: https://github.com/leejet/stable-diffusion.cpp/releases
+
+In the REPL:
+
+```text
+/backend sdcpp /path/to/qwen-image-2512-Q4_K_M.gguf /path/to/qwen_image_vae.safetensors /path/to/Qwen2.5-VL-7B-Instruct-*.gguf
+/t2i "a watercolor painting of a lighthouse" --sampling-method euler --offload-to-cpu --diffusion-fa --flow-shift 3 --open
+```
+
+Extra flags are forwarded via `request.extra`. In CLI mode they are forwarded to `sd-cli`; in python bindings mode, keys are mapped to python binding kwargs when supported and unsupported keys are ignored.
+
+### AbstractCore tool integration (artifact refs)
+
+If you’re using AbstractCore tool calling, AbstractVision can expose vision tasks as tools:
+
+```python
+from abstractvision.integrations.abstractcore import make_vision_tools
+
+tools = make_vision_tools(vision_manager=vm, model_id="zai-org/GLM-Image")
+```
+
+## Project
+
+- Release notes: `CHANGELOG.md`
+- Contributing: `CONTRIBUTING.md`
+- Security: `SECURITY.md`
+- Acknowledgments: `ACKNOWLEDMENTS.md`
+
+## Requirements
+
+- Python >= 3.8
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Author
+
+Laurent-Philippe Albou
+
+## Contact
+
+contact@abstractcore.ai

abstractvision-0.2.1.dist-info/RECORD

@@ -0,0 +1,23 @@
+abstractvision/__init__.py,sha256=X8elAB4DbOVU1ZRy1mDiSnuvLIBQK0Uikm6kb7EF11k,692
+abstractvision/__main__.py,sha256=pXsGul2Vonr-hhezpPCXz76NxzdaEAgQPFBMpZ81GQo,117
+abstractvision/artifacts.py,sha256=h0TWWbVx2zOI86vCamieIZ1fH_Uza1IkqYKbbMGNA-w,11346
+abstractvision/cli.py,sha256=fYrhfgJA_Zg40JjnWzR1kUr3mY0X6IhOjIl1byer4Fc,34296
+abstractvision/errors.py,sha256=-wvsCCOd3a9ztAmUj5fTnllkfe045RrrtaidvfUy01Y,633
+abstractvision/model_capabilities.py,sha256=1oKcw8bXgaIdg73DmPwvwvVppGEkZ4LWjo4Z-egg6_w,10176
+abstractvision/types.py,sha256=CJTmio8jtX-63zO5LVu34RSQ7NfdZVFfq6aOMwWX4so,2767
+abstractvision/vision_manager.py,sha256=pcnZb8doGujU1hO2K_M01VdJi_feveN2tpBOIJ8wARU,5375
+abstractvision/assets/vision_model_capabilities.json,sha256=LFu3gh7YtsPgKiGMcV0Qz0ukPcSPiTRpDMPdnUGYtDQ,14170
+abstractvision/backends/__init__.py,sha256=h2lDPlJBrH8IRstkm0V-Bnvh2bTXG4sLCBjfyjTh4nU,1729
+abstractvision/backends/base_backend.py,sha256=wboWF28FPhg4BMA0bCyg0FASlubrUhAH1SoPngN9UP0,2017
+abstractvision/backends/huggingface_diffusers.py,sha256=UACu5ggrMYNg1wd-yE1NJ_tsPCi8O6qilt6nqtpHKzo,60451
+abstractvision/backends/openai_compatible.py,sha256=RtLzdshoCuKgfZcnmXjSfoGdBHB3TAUqY__Cp0nAE-Y,13842
+abstractvision/backends/stable_diffusion_cpp.py,sha256=aeH3LD85NMQgZ1KVBjVmMXgjRYUb9NsM3NOWRGfY1wA,28733
+abstractvision/integrations/__init__.py,sha256=bw1iQ8xU0T82ej3V0Zda8Fgz_ZwgboWkSC8wqWvF3pc,149
+abstractvision/integrations/abstractcore.py,sha256=nr5_jO49Jd_s52LIMilrATYZv1xbP_omy9AumlNVoJM,10179
+abstractvision/integrations/abstractcore_plugin.py,sha256=VjJswb7s6wvAi3lWI1BDZlzdDsFm6tRJWj5dZo7RaUU,8061
+abstractvision-0.2.1.dist-info/licenses/LICENSE,sha256=ifO3lH7cJAMqNv7IWJlVUsJ_4FOBfoh1SkhzTkxQHd4,1079
+abstractvision-0.2.1.dist-info/METADATA,sha256=miH98efXN3SPPqPLv2bSl90LUHAIElPLA3WWven3cvA,8297
+abstractvision-0.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+abstractvision-0.2.1.dist-info/entry_points.txt,sha256=SioGhlJ_kSc4RYzjZAZ97zjBWc6CnBamk3OKdpn7Re4,170
+abstractvision-0.2.1.dist-info/top_level.txt,sha256=ZWt-i-WRPiqmiSny1lXgfS4oeN60q--SaJOaS8ft5UQ,15
+abstractvision-0.2.1.dist-info/RECORD,,

{abstractvision-0.1.0.dist-info → abstractvision-0.2.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

abstractvision-0.2.1.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[abstractcore.capabilities_plugins]
+abstractvision = abstractvision.integrations.abstractcore_plugin:register
+
+[console_scripts]
+abstractvision = abstractvision.cli:main

abstractvision-0.1.0.dist-info/METADATA

@@ -1,65 +0,0 @@
-Metadata-Version: 2.4
-Name: abstractvision
-Version: 0.1.0
-Summary: Generative vision capabilities for abstractcore.ai
-Home-page: https://github.com/abstractcore/abstractvision
-Author: Laurent-Philippe Albou
-Author-email: contact@abstractcore.ai
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-Dynamic: summary
-
-# abstractvision
-
-A Python project designed to work with abstractcore.ai and enable generative capabilities for vision.
-
-## Overview
-
-abstractvision provides vision-related generative capabilities as part of the abstractcore.ai ecosystem.
-
-## Installation
-
-```bash
-pip install abstractvision
-```
-
-## Usage
-
-```python
-from abstractvision import Vision
-
-# Example usage coming soon
-```
-
-## Requirements
-
-- Python >= 3.8
-
-## License
-
-MIT License - see LICENSE file for details.
-
-## Author
-
-Laurent-Philippe Albou
-
-## Contact
-
-contact@abstractcore.ai

abstractvision-0.1.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-abstractvision/__init__.py,sha256=f2PwzsC1Waw08X-N0qOHe2pu1AHKOqVaW3OG4ZuKtjM,227
-abstractvision-0.1.0.dist-info/licenses/LICENSE,sha256=ifO3lH7cJAMqNv7IWJlVUsJ_4FOBfoh1SkhzTkxQHd4,1079
-abstractvision-0.1.0.dist-info/METADATA,sha256=h_46a2CyvDNaPyxaWU_ExPZ3WT46d6IngYGdokKvoyM,1463
-abstractvision-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-abstractvision-0.1.0.dist-info/top_level.txt,sha256=ZWt-i-WRPiqmiSny1lXgfS4oeN60q--SaJOaS8ft5UQ,15
-abstractvision-0.1.0.dist-info/RECORD,,