# Introduction

**degirum-face** is a high-performance Python library for face detection, recognition, and tracking in images and video. Built for production deployments with minimal code and support for CPU and edge AI accelerators. Code examples and usage tutorials are available in the [DeGirum Face Recognition repo](https://github.com/DeGirum/face_recognition).

**Fast and efficient** face recognition with:

* Face detection, alignment, embedding extraction, and matching for images, video files, and live streams
* **Multi-hardware support**: CPU, GPU, and edge AI accelerators (Hailo, Axelera, DEEPX, Intel, NVIDIA, Rockchip, Google, DeGirum)
* **Simple APIs**: Minimal code to detect, enroll, and recognize faces with easy batch processing
* **Flexible configuration**: Python or YAML config for models, thresholds, and database paths
* **Production-ready tracking**: Real-time face re-identification, event notifications, and automated alert recording
* **Robust database**: LanceDB-based storage with vector similarity search

## Licensing

`degirum-face` is one of the application packages licensed by DeGirum. Licensing is managed through [DeGirum AI Hub](https://hub.degirum.com/). Users need to create an AI Hub account and set up a workspace with the appropriate permissions to generate licenses for `degirum-face`.

For complete information on application package licensing, see the [Application Package Licensing Guide](https://docs.degirum.com/ai-hub/application-package-licensing). For workspace plan details and pricing information, visit the [Workspace Plans](https://docs.degirum.com/ai-hub/workspace-plans) page and the [DeGirum Pricing Page](https://degirum.com/pricing).

The library provides code and pipelines for face recognition workflows. Model licensing is separate from the library licensing:

* **Face detection models**: Trained by DeGirum and can be used commercially when users license the `degirum-face` package
* **Face embedding models**: The ONNX file is from the [Hailo Model Zoo](https://github.com/hailo-ai/hailo_model_zoo) and is licensed under the MIT license (see [THIRD-PARTY-LICENSES.md](https://github.com/DeGirum/face_recognition/blob/main/THIRD-PARTY-LICENSES.md))

For complete licensing details, see the [Models Reference](/face-recognition/reference/models.md).

## Getting Started

Start with [Installation & Setup](/face-recognition/getting-started/installation.md) and [Basic Concepts](/face-recognition/getting-started/basic-concepts.md), then explore the [Guides](/face-recognition/guides/overview.md) for your use case.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.degirum.com/face-recognition/index.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.