Suri

LOCAL ATTENDANCE TRACKER

Local-first attendance tracking with on-device face recognition.
Explore Features »

Setup Guide · Report Bug · Request Feature

Suri is a desktop application for attendance tracking with on-device face recognition. Detection, recognition, and biometric storage stay on the local machine, which keeps the system usable offline and reduces exposure of sensitive data.

Local First	Consent Aware	Encrypted
Detection, recognition, and storage run on the device.	Biometric registration requires consent, and the registration view can shield non-consenting members.	Biometric templates are encrypted locally, and vault backups are password-protected.

Explore Features

---

Download

Note

Pre-compiled binaries are currently only available for Windows (.exe). macOS and Linux users can build from source manually.

Important

Please see the Installation Notes below before installing.

---

Installation Notes

Important

Suri is currently in Early Access. Because we are an independent open-source project, our binaries are not yet "notarized" by Microsoft or Apple.

For Windows Users:

If Windows SmartScreen (blue window) appears:

1. Click More info.
2. Click Run anyway.

We are currently in the process of applying for SignPath OSS to eliminate this warning.

For macOS Users:

If you see the "Unidentified Developer" warning:

1. Right-click Suri.dmg in your Applications folder/Downloads.
2. Select Open from the menu.
3. Click Open again in the dialog box.

This is a one-time step to grant permission.

---

Documentation

Project docs:

• Features & Capabilities - Groups, registration, attendance flows, and exports.
• Architecture & Stack - How the Electron app, local API, and database fit together.
• Installation & Setup - Build and run instructions.
• Troubleshooting - Common setup and runtime issues.
• Privacy & Security - What is stored, how consent works, and how biometric data is protected.

Tech Stack

Suri uses a small desktop-focused stack built around local execution.

Roadmap

Phase 1: Local Foundation (Completed)

• Face Recognition Pipeline: Local face recognition and liveness detection.
• Data Integrity: Atomic System Backups & Encrypted Vaults (.suri).
• Privacy Controls: Local storage, biometric consent tracking, and Privacy Shield enforcement.

Phase 2: Connectivity (In-Progress)

• Multi-Camera: Parallel RTSP stream support for large venues.
• Backup Sync: Optional encrypted backup synchronization between trusted deployments.

Phase 3: Ecosystem (Future)

• Web Dashboard: Centralized reporting and administration around local Suri deployments.
• Mobile Companion: Remote attendance check-in and automated notifications.

Visit the issues page to submit feature requests.

Contributing

Suri is open source. If you want to help make it better, pull requests are welcome.

1. Fork the project
2. Create a branch (git checkout -b feature/AmazingFeature)
3. Commit what you've built (git commit -m 'Add some AmazingFeature')
4. Push it to your fork (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the AGPL-3.0 License. See LICENSE for more information.

This project relies on open source software. See Third Party Licenses for details.

Acknowledgments

• FastAPI - High-performance local API framework.
• ONNX Runtime - Local inference runtime.
• Electron - Native desktop runtime.
• React - Desktop UI layer.
• OpenCV - Real-time image processing.

(back to top)