🧠 Face++ Custom Integration for Home Assistant

This Home Assistant custom integration lets you connect to Face++ (faceplusplus.com) for powerful face recognition features. Add faces to a FaceSet using your camera or local images, and identify people in real time from your Home Assistant camera feeds.

---

✨ Features

• ✅ Add faces to a FaceSet from:
  • Camera snapshots
  • Uploaded image files
• ✅ Recognize faces using the Face++ API
• ✅ UI-based configuration
• ✅ Emits events like:
  • faceplusplus_face_added
  • faceplusplus_user_id_added
  • faceplusplus_face_recognized

---

Install

Installation via HACS

Have HACS installed, this will allow you to update easily.

• Adding Face++ to HACS can be using this button:

Note

If the button above doesn't work, add https://github.com/asmsaifs/ha-faceplusplus as a custom repository of type Integration in HACS.

• Click Install on the Face++ integration.
• Restart the Home Assistant.

Manual installation

• Copy faceplusplus folder from latest release to custom_components folder in your config directory.
• Restart the Home Assistant.

📁 Configuration

⚙️ Configuration > Devices and Services > 🧩 Integrations > ➕ Add Integration > 🔍 Search Face++

Or click:

Services

faceplusplus.add_faces

Add faces from camera.

Example service data:

camera_entity: camera.living_room
user_id: Karim

---

faceplusplus.add_faces_from_files

Add faces from files in given folder path.

Example service data:

folder_path: /config/www/faces
user_id: Karim

---

faceplusplus.recognize_face

Recognizes a face from a camera snapshot.

Example service data:

camera_entity: camera.front_door

---

faceplusplus.recognize_face_from_file

Recognizes a face from a image file.

Example service data:

file_path: /config/www/faces/karim-1.jpg

Known Limitations

• Only one face is processed per frame.
• Camera snapshots must be accessible through Home Assistant.

License

MIT License

Contributing

Pull requests and feature suggestions are welcome!

---

Note: This is a community integration and is not officially supported by Face++ or Home Assistant.