Metadata-Version: 2.1
Name: marearts-anpr
Version: 0.2604.2907
Summary: MareArts ANPR (Automatic Number Plate Recognition) library with multi-region support
Home-page: https://www.marearts.com
Author: MareArts
Author-email: MareArts <hello@marearts.com>
License: Proprietary
Project-URL: Homepage, https://github.com/marearts/marearts-anpr
Keywords: anpr,license plate recognition,computer vision,ocr,vehicle detection
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: Programming Language :: Python :: 3.14
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: marearts-crystal>=2.5.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: pillow>=10.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn>=0.23.0
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: httpx>=0.24.0
Requires-Dist: onnxruntime>=1.15.0; python_version < "3.13"
Requires-Dist: numpy<2.0,>=1.23.0; python_version == "3.10"
Requires-Dist: numpy<3.0,>=1.23.0; python_version == "3.11"
Requires-Dist: numpy<3.0,>=1.26.0; python_version == "3.12"
Requires-Dist: numpy<3.0,>=2.0.0; python_version >= "3.13"
Requires-Dist: onnxruntime>=1.24.2; python_version >= "3.13"
Provides-Extra: all-gpu
Requires-Dist: tensorrt>=8.6.0; platform_system == "Linux" and extra == "all-gpu"
Requires-Dist: pycuda>=2022.1; platform_system == "Linux" and extra == "all-gpu"
Requires-Dist: onnxruntime-gpu>=1.15.0; python_version < "3.13" and extra == "all-gpu"
Requires-Dist: onnxruntime-directml>=1.15.0; python_version < "3.13" and extra == "all-gpu"
Requires-Dist: onnxruntime-gpu>=1.24.2; python_version >= "3.13" and extra == "all-gpu"
Requires-Dist: onnxruntime-directml>=1.24.2; python_version >= "3.13" and extra == "all-gpu"
Provides-Extra: cuda
Requires-Dist: onnxruntime-gpu>=1.15.0; python_version < "3.13" and extra == "cuda"
Requires-Dist: onnxruntime-gpu>=1.24.2; python_version >= "3.13" and extra == "cuda"
Provides-Extra: directml
Requires-Dist: onnxruntime-directml>=1.15.0; python_version < "3.13" and extra == "directml"
Requires-Dist: onnxruntime-directml>=1.24.2; python_version >= "3.13" and extra == "directml"
Provides-Extra: full
Requires-Dist: marearts-anpr[mcp]; extra == "full"
Provides-Extra: gpu
Requires-Dist: onnxruntime-gpu>=1.15.0; python_version < "3.13" and extra == "gpu"
Requires-Dist: onnxruntime-gpu>=1.24.2; python_version >= "3.13" and extra == "gpu"
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == "mcp"
Provides-Extra: server
Requires-Dist: fastapi>=0.100.0; extra == "server"
Requires-Dist: uvicorn>=0.23.0; extra == "server"
Requires-Dist: python-multipart>=0.0.6; extra == "server"
Provides-Extra: tensorrt
Requires-Dist: tensorrt>=8.6.0; platform_system == "Linux" and extra == "tensorrt"
Requires-Dist: pycuda>=2022.1; platform_system == "Linux" and extra == "tensorrt"

# MareArts ANPR

[![PyPI version](https://badge.fury.io/py/marearts-anpr.svg)](https://badge.fury.io/py/marearts-anpr)
[![Python versions](https://img.shields.io/pypi/pyversions/marearts-anpr.svg)](https://pypi.org/project/marearts-anpr/)
[![Downloads](https://pepy.tech/badge/marearts-anpr)](https://pepy.tech/project/marearts-anpr)
[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](https://www.marearts.com/products/anpr)
[![Live Demo](https://img.shields.io/badge/demo-live-brightgreen.svg)](http://live.marearts.com)

Automatic Number Plate Recognition SDK — detection + OCR for multiple regions, with GPU acceleration and ARM/Windows support.

**One license covers everything:** Python SDK, REST API Server, and Mobile App.

---

## Python SDK

Detect and read license plates in your own Python code.

```bash
pip install marearts-anpr          # CPU
pip install marearts-anpr[gpu]     # NVIDIA CUDA
```

```python
from marearts_anpr import (
    ma_anpr_detector_v16, ma_anpr_ocr_v16, marearts_anpr_from_image_file
)

detector = ma_anpr_detector_v16("640p_fp32", user_name, serial_key, signature)
ocr = ma_anpr_ocr_v16("fp32", "univ", user_name, serial_key, signature)

result = marearts_anpr_from_image_file(detector, ocr, "car.jpg")
print(result)
# {'results': [{'ocr': 'ABC1234', 'ocr_conf': 99, 'ltrb': [...], ...}], ...}
```

**[Full SDK Documentation and Examples →](python-sdk/)**

---

## REST API Server

Built-in server with web dashboard, REST API, and Docker support.

```bash
pip install marearts-anpr[server]
ma-anpr config                     # one-time credential setup
ma-anpr server start               # http://localhost:8000
```

```bash
curl -X POST http://localhost:8000/api/anpr -F "image=@car.jpg"
```

**[Server Documentation →](server/)**

---

## Mobile App

On-device ANPR for iOS and Android — parking, security, fleet management.

[![Download on App Store](https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg)](https://apps.apple.com/us/app/marearts-anpr/id6753904859) [![Get it on Google Play](https://raw.githubusercontent.com/MareArts/MareArts-ANPR/main/promotion_image/google_play_badge.svg)](https://play.google.com/store/apps/details?id=com.marearts.anpr)

- On-device AI (~100-160ms)
- Team collaboration, webhooks, cloud sync
- CSV export, map view, whitelist/blacklist

**[Mobile App Guide →](mobile-app/)**

---

## Supported Regions

| Code | Region | Description |
|------|--------|-------------|
| `univ` | Universal | All regions (default) |
| `eup` | Europe+ | EU, UK, ex-USSR, Asia, Africa, Oceania |
| `na` | North America | US, CA, MX |
| `kr` | Korea | South Korea |
| `cn` | China | China |
| `jp` | Japan | Japan |

Also accepts country codes (`de`, `us`, `au`) or names (`germany`, `korea`).

---

## More from MareArts

- **[MareArts Road Objects](https://github.com/MareArts/MareArts-Road-Objects)** — Detect persons, vehicles, and 2-wheelers
- **[MareArts Xcolor](https://github.com/MareArts/MareArts-Xcolor)** — Color extraction and similarity
- **[MareArts MAST](https://github.com/MareArts/MareArts-MAST)** — Real-time panoramic stitching

---

## Support

| | |
|---|---|
| Homepage | [marearts.com](https://marearts.com) |
| License | [marearts.com/products/anpr](https://www.marearts.com/products/anpr) |
| Live Demo | [live.marearts.com](http://live.marearts.com) |
| Contact | [hello@marearts.com](mailto:hello@marearts.com) |
| YouTube | [Video Examples](https://www.youtube.com/playlist?list=PLvX6vpRszMkxJBJf4EjQ5VCnmkjfE59-J) |

---

(c) 2025 MareArts. All rights reserved.
