Repository navigation
SnakeSense Release v1.0
This release introduces SnakeSense, a snake species classifier AI model available in two formats:
- ONNX model (
model.onnx) — optimized for cross-platform deployment, outputs a predicted species index (0–134). - FastAI PyTorch model (
model.pkl) — convenient for direct use with FastAI, outputs a predicted class ID.
Model Details
- Architecture: ResNet101
- Framework: FastAI
- Training Platform: Kaggle
- Dataset: 165 Different Snakes Species
- Training Epochs: 100
- Training Accuracy: 66.1%
Model Outputs & Lookup
| Format | Output | Lookup Key in species.csv |
|---|---|---|
.pkl (FastAI) |
class_id (integer) |
class_id |
.onnx |
index (integer) |
index |
Use the included species.csv file to map model outputs to detailed species information including common name, scientific name, venom status, and geographic data.
Included Files
model.onnx— ONNX export of the trained modelmodel.pkl— FastAI exported model for easy inference in Pythonspecies.csv— CSV mapping indices and class IDs to species metadata
Usage Examples
- Use
model.pklwith FastAI for simple Python inference and easy integration. - Use
model.onnxfor cross-platform inference with ONNX Runtime.
Refer to the README for detailed code examples.
Disclaimer
This is an early version intended for experimentation. The model is not production-ready, and no AI can guarantee perfect accuracy. Please seek professional help if bitten by a snake and do not rely solely on this tool for safety decisions.
Feedback, contributions, and questions are highly welcome!