Quick Start With The Free Demo

The Demo is the full product with limits: the light recognition model, passive liveness, the browser webcam in Live view, 100 people, 50 API calls an hour and 14 days from activation. It needs internet access to activate and checks in with ARSA once a day.

Before You Start

• A Linux computer (x86_64 with AVX2) with Docker installed, and permission to run sudo. Rootless Docker is not supported for the Demo.
• 2 GB of free memory.
• A Demo licence key: request one with your company e-mail on the Face SDK page. The key arrives by e-mail. One Demo per company.
• For the NVIDIA image: an NVIDIA GPU with driver 535 or newer and the NVIDIA Container Toolkit.

Run It

1. Start the container with your key:

   sudo docker run -d --name face-sdk-demo -p 8080:8080 \
     -e ARSA_LICENCE_KEY=<your key> \
     -v face-data:/data \
     -v /sys:/host/sys:ro -v /etc/machine-id:/host/etc/machine-id:ro \
     arsatech/face-sdk:2.0.1-demo

   On an NVIDIA GPU add --gpus all and use arsatech/face-sdk:2.0.1-demo-cuda.

2. Read the start-up output:

   sudo docker logs face-sdk-demo

   It shows an API key for your systems (nf_live_...), a dashboard setup token, and [✓] ACTIVATED with the days left. Store the API key now: it is shown only once.

3. Open http://localhost:8080, enter the setup token and create the owner account (see First Run).

Run the command in a terminal on the Linux machine you want to use for the Demo. It needs sudo; rootless Docker is not supported for the Demo. The Demo can move to another machine twice in its 14 days, one machine at a time. The face-data volume keeps your people, keys and licence state: without it they are lost when the container is removed.

Make Your First Call

Compare two photos of the same person:

curl -X POST http://localhost:8080/v2/verify \
  -H "x-api-key: $API_KEY" \
  -F image1=@photo1.jpg -F image2=@photo2.jpg

The answer holds the decision, the similarity and the threshold that decided it:

{
  "decision": "match",
  "match": true,
  "similarity": 0.8312,
  "threshold": 0.3479,
  "operating_point": { "profile": "access", "far": 0.0001, "threshold": 0.3479 }
}

Next: enrol people and search for them, or try every call in the dashboard’s Sandbox.

When The Demo Ends

After 14 days analysis stops: the API refuses face calls and the dashboard shows that the Demo has ended, with a link to buy a licence. Your data stays on the face-data volume. To remove everything:

sudo docker rm -f face-sdk-demo && sudo docker volume rm face-data