Skip to content

MareArts/MareArts-ANPR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

124 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

MareArts ANPR SDK

PyPI version Python versions Downloads License: Proprietary Live Demo

Python SDK iOS App

ANPR Detection Road Objects Detection Mobile App
ANPR Results Road Objects Results Mobile App

Automatic Number Plate Recognition (ANPR) SDK for multiple regions with GPU acceleration support.

๐Ÿ’Ž One License, All Access: SDK + Mobile App + Road Objects Detection - Use everywhere with a single license.


๐ŸŽ‰ MareArts ANPR Mobile App - v1.8.0 Update!

๐Ÿ“ฑ Now available on iOS! Android coming soon.

Experience the power of MareArts ANPR directly on your mobile device! Fast, accurate, on-device license plate recognition for parking management, security, and vehicle tracking.

Download on App Store

โœจ Key Features:

  • ๐Ÿš€ Fast on-device AI processing (~100-160ms)
  • ๐Ÿ“‹ NEW: Smart rules grouping - Organized A-Z for easy navigation
  • ๐ŸŒ NEW: Download rules from web - Upload on marearts.com, download on phone
  • ๐Ÿ”„ NEW: Background sync - Keep using app while syncing
  • ๐Ÿ”„ Complete cloud sync - Keep data in sync across devices
  • ๐Ÿ“Š CSV export/import - Professional data management
  • ๐Ÿ”’ 100% offline capable - privacy first
  • ๐Ÿ“Š Statistics and analytics
  • ๐Ÿ—บ๏ธ Map view with GPS tracking
  • โœ… Whitelist/Blacklist management
  • ๐ŸŒ Multi-region support

๐Ÿ“– Read the complete Mobile App Guide โ†’

๐Ÿ†• Version 1.8.0: Faster performance, smart rules grouping, web-to-phone rule downloads, and background sync!

๐ŸŽ Special Offer: Use the mobile app as your ANPR license - no additional purchase required!
Get your license at marearts.com/products/anpr


๐ŸŒ NEW: ANPR Management Server

Professional server with REST API and Web Dashboard

Deploy a complete ANPR management system with real-time monitoring, detection history, and visual analytics.

Management Server Dashboard

Quick Start:

cd management_server
pip install -r requirements.txt  # First time only
ma-anpr config                   # Configure credentials
python server.py                 # Start server
# Open http://localhost:8000/

Features: REST API, Web Dashboard, Real-time logs, SQLite database, Live model switching

๐Ÿ“– Full Documentation โ†’



MareArts ANPR SDK Features

  • ๐ŸŒ Multi-Region Support: Korean, Europe+, North America, China, and Universal license plates
  • ๐Ÿ”„ Dynamic Region Switching: Change regions instantly with set_region() without model reload
  • โšก GPU Acceleration: CUDA, DirectML support for real-time processing
  • ๐ŸŽฏ High Accuracy: Advanced models with regional vocabulary optimization
  • ๐Ÿ“ฆ Batch Processing: Process multiple plates simultaneously
  • ๐Ÿณ Production Ready: Docker API with smart model caching and multi-architecture support

Quick Start

Installation

# CPU Installation
pip install marearts-anpr

# GPU Installation (CUDA, DirectML)
pip install marearts-anpr[gpu]        # NVIDIA CUDA
pip install marearts-anpr[directml]   # Windows GPU (AMD/Intel/NVIDIA)

๐Ÿ“ฆ See complete installation guide

Basic Usage

from marearts_anpr import ma_anpr_detector_v14, ma_anpr_ocr_v14, marearts_anpr_from_image_file

# Initialize detector
detector = ma_anpr_detector_v14(
    "micro_320p_fp32",
    # 320p models (Fast): pico_320p_fp32/fp16, micro_320p_fp32/fp16, small_320p_fp32/fp16, medium_320p_fp32/fp16, large_320p_fp32/fp16
    # 640p models (High detection): pico_640p_fp32/fp16, micro_640p_fp32/fp16, small_640p_fp32/fp16, medium_640p_fp32/fp16, large_640p_fp32/fp16
    user_name,
    serial_key,
    signature,
    backend="cuda",  # cpu, cuda, directml (auto-selected if "auto")
    conf_thres=0.25,  # Detection confidence threshold (default: 0.25)
    iou_thres=0.5     # IoU threshold for NMS (default: 0.5)
)

# Initialize OCR with regional vocabulary
ocr = ma_anpr_ocr_v14(
    "small_fp32",       # Model: pico_fp32, micro_fp32, small_fp32, medium_fp32, large_fp32
    "univ",             # Region: kr, eup, na, cn, univ (choose specific region for best accuracy)
    user_name,
    serial_key,
    signature,
    backend="cuda",  # cpu, cuda, directml (auto-selected if "auto") 
)

# Process image
result = marearts_anpr_from_image_file(detector, ocr, "image.jpg")
print(result)
# Output: {'results': [{'ocr': 'ABC123', 'ocr_conf': 99, ...}], ...}

๐Ÿ’ก ๐Ÿ”„ Learn more about usage

Dynamic Region Switching

Switch regions without reinitialization:

ocr.set_region('eup')  # Europe+
ocr.set_region('kr')   # Korean
ocr.set_region('na')   # North America
ocr.set_region('cn')   # China
ocr.set_region('univ') # Universal (all regions)

๐Ÿ”„ Learn more about dynamic region switching

Multiple Input Formats & CLI

From different image sources:

import cv2
from PIL import Image
from marearts_anpr import marearts_anpr_from_cv2, marearts_anpr_from_pil

result = marearts_anpr_from_cv2(detector, ocr, cv2.imread("image.jpg"))
result = marearts_anpr_from_pil(detector, ocr, Image.open("image.jpg"))
result = marearts_anpr_from_image_file(detector, ocr, "image.jpg")

CLI commands:

ma-anpr image.jpg                    # Process image
ma-anpr test-api image.jpg           # Test API (1000/day limit)
ma-anpr validate                     # Validate license

๐Ÿ”ง See complete usage examples and CLI reference


Model Performance

Detector Performance

Model Name Detection Rate Speed (GPU) Notes
micro_320p_fp32 97.13% 128 FPS (7.8ms) ๐Ÿ† Best overall
micro_320p_fp16 97.13% 56 FPS (17.9ms) ๐Ÿ† Best mobile (50% smaller)
micro_640p_fp32 98.99% 68 FPS (14.6ms) Highest detection
small_320p_fp32 98.00% 142 FPS (7.0ms) โšก Fastest
medium_320p_fp32 98.06% 136 FPS (7.4ms) High detection
pico_320p_fp32 96.02% 129 FPS (7.8ms) Smallest + fast
pico_640p_fp32 98.54% 66 FPS (15.2ms) Balanced

Note: 320p models are 2ร— faster than 640p. FP16 models are 50% smaller with same detection rate.


OCR Performance

Average across all regions

Model Name Exact Match Character Accuracy Speed (GPU) Notes
large_fp32 91.70% 96.27% 262 FPS (3.8ms) ๐ŸŽฏ Best accuracy
micro_fp32 91.86% 96.50% 262 FPS (3.8ms) Fast with good accuracy
pico_fp32 91.78% 96.65% 270 FPS (3.7ms) Fastest, smallest
small_fp32 91.54% 96.64% 300 FPS (3.3ms) โšก Fastest inference
medium_fp32 90.36% 96.45% 270 FPS (3.7ms) Balanced performance

Supported Regions: Korean (kr), Europe+ (eup), North America (na), China (cn), Universal (univ)

๐Ÿ“Š See all models and benchmarks


Regional Support

MareArts ANPR supports license plates from multiple regions with specialized vocabulary optimization:

  • ๐Ÿ‡ฐ๐Ÿ‡ท Korean (kr) - Korean license plates with Hangul characters (best accuracy: 99.27%)
  • ๐Ÿ‡ช๐Ÿ‡บ Europe+ (eup) - EU countries + Albania, Andorra, Bosnia & Herzegovina, Indonesia, and more
  • ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡จ๐Ÿ‡ฆ๐Ÿ‡ฒ๐Ÿ‡ฝ North America (na) - USA, Canada, and Mexico license plates
  • ๐Ÿ‡จ๐Ÿ‡ณ China (cn) - Chinese license plates with province codes
  • ๐ŸŒ Universal (univ) - All regions (default, but choose specific region for best accuracy)

๐Ÿ’ก Dynamic Region Switching: Use ocr.set_region('kr') to switch regions instantly without reloading the model, saving ~180 MB per additional region.

๐ŸŒ See complete regional support and character sets


Documentation

  • ๐Ÿ“ฆ Installation Guide - Detailed installation options and requirements
  • ๐Ÿ”ง Usage Examples - Python SDK, CLI usage, dynamic region switching, and environment variables
  • ๐Ÿ’ป Example Code - Basic, advanced, and batch processing examples
  • ๐Ÿš€ Model Versions - Available models, benchmarks, and performance metrics
  • ๐ŸŒ Regional Support - Supported countries and character sets
  • ๐Ÿณ Docker Deployment - Container setup, API server, and multi-architecture builds
  • ๐Ÿงช Try ANPR - Test our ANPR without license (1000 requests/day)
  • โ“ FAQ - Licensing, regions, features, and troubleshooting

MareArts Ecosystem

Explore our AI toolkit:

  • marearts-anpr - Automatic Number Plate Recognition (GitHub)
  • ๐ŸŽ‰ marearts-anpr Mobile App - ANPR on iOS & Android (App Store | Guide)
  • marearts-road-objects - Road object detection for persons, vehicles, and 2-wheelers (GitHub)
  • marearts-xcolor - Color extraction and similarity analysis (GitHub)
  • marearts-mast - Real-time panoramic stitching (GitHub)
  • marearts-crystal - Encryption and decryption toolkit (PyPI)

Support & Resources

Resource Link
๐Ÿ“ง Contact [email protected]
๐Ÿ  Homepage https://marearts.com
๐Ÿ’ณ License Purchase ANPR Solution
๐ŸŽฎ Live Demo http://live.marearts.com
๐Ÿ“บ Video Examples YouTube Playlist

License

ยฉ 2024 MareArts. All rights reserved.

This software requires a valid license key. Visit MareArts ANPR Solution for licensing options.


Visitor Map