ANPR SDK Server (MASS)

Desktop app · Windows · macOS · Ubuntu · Beta

MASS

MareArts ANPR SDK Server. The MareArts ANPR engine as a desktop app: read plates from images and folders, keep a history and a watchlist, and serve the REST API to your own software, on your own computer, with no Python setup.

Beta · testers wanted

MASS is in beta, with the new ANPR SDK 4.0. Join the ANPR SDK + MASS beta: beta testers get a license for the test period and the download.

MASS runs the same engine and dashboard as ma-anpr server in the ANPR SDK, packaged with everything it needs. One ANPR SDK + MASS license covers both.

Download

One installer per system

SystemFileInstall
Windows 10 & 11, 64-bit.msiRun it. If SmartScreen appears, choose More info → Run anyway: the installer is not code-signed yet
macOS, Apple Silicon.dmgOpen it and drag MareArts ANPR SDK Server to Applications. Signed and notarized by Apple
macOS, Intel.dmgThe same
Ubuntu 24.04 / Mint 22.debDouble-click and Install
Ubuntu 22.04 / Mint 21.debDouble-click and Install

All files are on the download page, after you sign in to marearts.com. Five downloads a day per account; updating an installed copy does not count.

Sign in to MASS

On marearts.com, use your email and a 6-digit sign-in code; no sign-up or password is needed. In MASS, use the licence details below.

With your licence key, on this computer

  1. Open MASS. It starts with a sign-in window.
  2. Enter your e-mail and your MAEV3 licence key from your My licenses page. The key is checked on this computer: no internet is needed to sign in.
  3. Existing MareArts ANPR (SDK + Mobile) subscribers can also add the 16-character signature from the same page, for cloud MMC (car details). Nothing else needs it.
  4. The models download once (about 600 MB). Plate reading starts when they are in place.
No internet

A computer that stays offline signs in the same way. Copy the whole .marearts/anpr folder in your home folder (models and their certificates) from a computer where MASS or ANPR SDK 4 already downloaded the models.

No key at hand? Existing MareArts ANPR (SDK + Mobile) subscribers can sign in online with their signature in the same window; it fetches the key. The key is kept on this computer only and is not shown again in the window. Sign out, under System → Account, removes it and brings the sign-in window back.

Keeps running

Closing the window does not stop MASS: the engine and the REST API keep running, and the Dock or taskbar icon opens the window again. To stop it, click the MASS chip in the corner of the window and choose Quit MASS, or quit from the Dock.

Updates

When a new version is out, the chip in the corner of the window says Update available. One click downloads it, checks it and starts MASS again. Turn on Beta updates there to get test builds first. Updating from inside MASS uses your licence key; without internet, MASS keeps working on the version it has.

Screens

Nine pages in one window

PageDoes
LiveCameras watching now and one event per vehicle pass with its best picture; a blacklisted plate stands out and can play a sound
CamerasIP cameras (RTSP), webcams, streams and video files; many at once from CSV or Excel, ONVIF search, a weekly schedule
OutputsWebhooks (signed) and files that receive each event; nothing is lost while a receiver is down
DetectionsEvery read, with make, model and colour when MMC is on; search, filter and export CSV or Excel
RulesWhitelist and blacklist with notes, wildcards and zones; upload or export CSV and Excel
RecognizeRead the plates in one picture, several, or a whole folder
APIThe REST API on this computer with ready-to-copy examples, and the Live API for your own programs
LogsWhat the engine did
SystemAccount, region, engine and models, and AI agents (Claude, Cursor, VS Code and other MCP apps)
Live: a camera playing a video file, a switched-off camera, and the events list with two blacklist hits Live: a camera playing a video file, a switched-off camera, and the events list with two blacklist hits
Live
Cameras: an IP camera switched off and a video file being watched Cameras: an IP camera switched off and a video file being watched
Cameras
Outputs: events written to a file, with the JSON that is sent Outputs: events written to a file, with the JSON that is sent
Outputs
Detections: reads with pictures, confidence and the whitelist or blacklist they matched Detections: reads with pictures, confidence and the whitelist or blacklist they matched
Detections
Rules: five plates on the whitelist or blacklist, each with a note Rules: five plates on the whitelist or blacklist, each with a note
Rules
Recognize: four pictures read, with the plates found in each Recognize: four pictures read, with the plates found in each
Recognize
API: the address, and Python examples for reading a picture and searching past reads API: the address, and Python examples for reading a picture and searching past reads
API
Logs: the engine loading its models and each read Logs: the engine loading its models and each read
Logs
System: the account, the reading region, the engine, and the AI agents switches System: the account, the reading region, the engine, and the AI agents switches
System

REST API

Your software calls the same engine

While MASS is running, its engine answers on this computer (127.0.0.1), port 8000 unless something else holds it. The endpoints are the ANPR SDK server's.

curl http://127.0.0.1:8000/api/health
curl -X POST http://127.0.0.1:8000/api/anpr -F "image=@car.jpg"

Swagger is at /docs. The full endpoint list is in the ANPR SDK's Server section.

Already running

If ma-anpr server is already running on port 8000, MASS shows that engine and never stops it. An engine MASS started stops when you quit MASS.

MASS or pip

Same engine, two ways to run it

MASSpip install marearts-anpr-sdk
SetupAn installer, no PythonPython 3.10–3.14
UseA window with the dashboard, plus the REST APIYour own scripts, the CLI, the server, Docker
HardwareCPUCPU, or GPU with ma-anpr gpu-setup
Where it fitsA desk, a small office, trying ANPR outServers, pipelines, headless machines
StatusBeta (0.2.5)4.0.0, with the MAEV3 key. 3.x with a MAEV2 key stays marearts-anpr 3.9.1

Requirements

Windows10 or 11, 64-bit
macOS11 or later, Apple Silicon or Intel (tested on macOS 15 and 26)
LinuxUbuntu 22.04 or 24.04 and their Mint and Pop!_OS releases, 64-bit x86
DiskThe installer (45–140 MB) and the models (about 600 MB)
InternetOnce, to download the models (and to sign in online with your signature). The key check and plate reading run on this computer

Support

License and next steps

  1. The ANPR SDK + MASS license is separate from ANPR Mobile. Beta testers get one for the test period.
  2. Download MASS from the download page (beta testers and license holders). Not one yet? Join the ANPR SDK + MASS beta.
  3. Open MASS and sign in with your e-mail and licence key.

MASS 0.2.5 · engine marearts-anpr-sdk 4.0.0