Releases: tit-exe/OrangIdentifier_AndroidApp
Release list
v4
OrangIdentifier Android - V4.0
Release of the 4th major version of the OrangIdentifier Android companion app. This offline mobile application allows field users to photograph Bornean orangutans and identify them in real-time, completely without internet access.
Historical context: V1 used a ResNet closed-set classifier, V2 moved to ResNet embeddings, V3 introduced MegaDescriptor with a single centroid per individual. This V4 release integrates the V6 AI model and upgrades the gallery format and scoring system accordingly, using SubCenterArcFace training and a multi-exemplar representation for significantly improved recognition accuracy.
🌟 Key Changes from V3
- Multi-exemplar gallery (model V6): Each individual is now represented by 25 exemplar vectors (768-dim each) instead of a single centroid. The recognition score is computed as
max(dot(query, exemplar_i))over all 25 exemplars, capturing natural appearance variability across angles and lighting conditions far better than an average vector. - New gallery: 15 known individuals, calibrated threshold of 0.5371, separability gap of 0.6711.
- Gallery management: Full gallery export, per-individual patch sharing, automatic versioning with up to 20 restore points, and one-tap undo.
- Field photos: Add photos to an existing individual's profile in the field. Stored separately from the training exemplars and merged at inference time.
- Model hot-swap: Import a new backbone or detector as a
.zipbundle via Settings without reinstalling the app.
🌟 Features
- 100% Offline Inference: Runs entirely on-device using optimized TensorFlow Lite models.
- V6 AI Pipeline (MegaDescriptor-T-224 + SubCenterArcFace): YOLO v2 face detector + Swin Transformer backbone producing 768-dim embeddings, matched against 25 exemplars per individual for open-set recognition.
- Instant Onboarding: Add new individuals directly from the app with at least 5 photos. The prototype is computed and saved to the local gallery immediately, no retraining required.
- Gallery Sharing: Export the full gallery or individual patches as JSON files and share them with other devices.
- Automatic Backups: Every gallery modification creates a backup. Full restore history accessible from Settings.
- Scan History: A local Room database keeps a log of all past identifications.
📥 Installation
- Download the
app-release.apkattached to this release under Assets. - Open the APK file on your Android device to install it. You may need to enable Install from unknown sources in your Android settings.
All models and the gallery are included directly in the repository. Clone the project, open it in Android Studio, sync Gradle, and build.
v3
OrangIdentifier Android - V3.0
Release of the 3rd major version of the OrangIdentifier Android companion app. This offline mobile application allows field rangers to photograph Bornean orangutans and identify them in real-time, completely without internet access.
Historical context: V1 used a ResNet closed-set classifier, V2 moved to ResNet embeddings. This V3 release introduces a major architectural upgrade with MegaDescriptor.
🌟 Key Features
- 100% Offline Inference: Runs entirely on-device using optimized TensorFlow Lite models.
- V3 Pipeline (MegaDescriptor): Uses the state-of-the-art V3 pipeline with a YOLO v2 face detector and a MegaDescriptor-T backbone for high-accuracy open-set recognition (reliably rejects unknown individuals).
- Instant Onboarding: Add new individuals directly from the app in less than a minute. The embedding is immediately saved to the local gallery without any model retraining.
- Scan History: A local Room database keeps a log of all past identifications.
- Real-time Correction: Correct wrong predictions on the fly to continuously improve an individual's prototype vector.
📥 Installation Instructions
- Download the
orangs_android_app_v3.apkattached to this release under Assets. - Open the APK file on your Android device to install it. (You may need to enable "Install from unknown sources" in your Android settings).
⚠️ Note for Developers
This APK is ready to use. However, if you are building the project from source, remember that the heavy backbone model (megadesc_T_arcface_backbone.tflite, 112MB) is not included in the source code due to GitHub file size limits. You must download it manually from the HuggingFace repository and place it in the app/src/main/assets/ directory before building.