Metadata-Version: 2.4
Name: vizion3d
Version: 1.3.2
Summary: U3D Capability and Intelligence for the real world. 
Project-URL: Homepage, https://github.com/OlafenwaMoses/vizion3D
Project-URL: Documentation, https://olafenwamoses.github.io/vizion3D
Project-URL: Repository, https://github.com/OlafenwaMoses/vizion3D
Project-URL: Issues, https://github.com/OlafenwaMoses/vizion3D/issues
License: MIT
License-File: LICENSE
Keywords: 3d,ai,artificial intelligence,computer-vision,depth-estimation,lidar,llm,mesh,nerf,point-cloud,reconstruction,slam
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: clean-ioc>=1.3.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: grpcio-tools>=1.60.0
Requires-Dist: grpcio>=1.60.0
Requires-Dist: open3d>=0.18.0
Requires-Dist: orjson>=3.9.0
Requires-Dist: pillow>=12.2.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: transformers>=5.6.2
Requires-Dist: ultralytics>=8.3.0
Requires-Dist: uvicorn>=0.23.0
Provides-Extra: amd
Provides-Extra: cpu
Requires-Dist: torch>=2.4.0; extra == 'cpu'
Requires-Dist: torchvision>=0.19.0; extra == 'cpu'
Provides-Extra: cuda
Provides-Extra: mps
Requires-Dist: torch>=2.4.0; extra == 'mps'
Requires-Dist: torchvision>=0.19.0; extra == 'mps'
Description-Content-Type: text/markdown

# vizion3D

**vizion3d** is an open-source Python library for 3D computer vision — a single unified interface for depth estimation, point cloud generation, 3D object annotation, and more.

📖 **[Full documentation →](https://olafenwamoses.github.io/vizion3D/)**

---

![input image](https://olafenwamoses.github.io/vizion3D/assets/images/roomhd.jpg)

![depth map](https://olafenwamoses.github.io/vizion3D/assets/images/roomhd_depth.png)

---

## Installation

Requires **Python 3.12** (Open3D constraint).

```bash
pip install "vizion3d[cpu]"
```

For NVIDIA CUDA, AMD ROCm, or Apple Silicon MPS, see the [Hardware Acceleration](https://olafenwamoses.github.io/vizion3D/hardware_acceleration/) page.

---

## Quick start — depth estimation

```python
import open3d as o3d
from vizion3d.lifting import DepthEstimation, DepthEstimationCommand

result = DepthEstimation().run(
    DepthEstimationCommand(
        image_input="roomhd.jpg",
        return_depth_image=True,
        return_point_cloud=True,
    )
)

print(f"Depth range : {result.min_depth:.4f} → {result.max_depth:.4f}")
print(f"Points      : {len(result.point_cloud.points)}")
print(f"Scale       : {result.point_cloud_scale} metre per unit")

o3d.io.write_point_cloud("roomhd_result.ply", result.point_cloud)
```

---

## Quick start — 3D object annotation

```python
import open3d as o3d
from vizion3d.annotation import ObjectMaskAnnotation3D, ObjectMaskAnnotation3DCommand

pcd = o3d.io.read_point_cloud("roomhd_result.ply")

result = ObjectMaskAnnotation3D().run(
    ObjectMaskAnnotation3DCommand(
        point_cloud=pcd,
        image_input="roomhd.jpg",
        return_annotated_cloud=True,
    )
)

for ann in result.annotations:
    print(f"{ann.label:20s}  conf={ann.confidence:.2f}  3D points={len(ann.point_indices)}")

o3d.io.write_point_cloud("annotated.ply", result.annotated_cloud)
```

---

## Documentation

Full reference, REST/gRPC guides, hardware setup, and task catalogue:

**[https://olafenwamoses.github.io/vizion3D/](https://olafenwamoses.github.io/vizion3D/)**
