Instructions to use MalithaBandara/EleGuard with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use MalithaBandara/EleGuard with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="MalithaBandara/EleGuard", filename="gemma-4-e2b-it.F16-mmproj.gguf", )
llm.create_chat_completion( messages = "No input example has been defined for this model task." )
- Notebooks
- Google Colab
- Kaggle
- Local Apps
- llama.cpp
How to use MalithaBandara/EleGuard with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf MalithaBandara/EleGuard:F16 # Run inference directly in the terminal: llama-cli -hf MalithaBandara/EleGuard:F16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf MalithaBandara/EleGuard:F16 # Run inference directly in the terminal: llama-cli -hf MalithaBandara/EleGuard:F16
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf MalithaBandara/EleGuard:F16 # Run inference directly in the terminal: ./llama-cli -hf MalithaBandara/EleGuard:F16
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf MalithaBandara/EleGuard:F16 # Run inference directly in the terminal: ./build/bin/llama-cli -hf MalithaBandara/EleGuard:F16
Use Docker
docker model run hf.co/MalithaBandara/EleGuard:F16
- LM Studio
- Jan
- Ollama
How to use MalithaBandara/EleGuard with Ollama:
ollama run hf.co/MalithaBandara/EleGuard:F16
- Unsloth Studio new
How to use MalithaBandara/EleGuard with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for MalithaBandara/EleGuard to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for MalithaBandara/EleGuard to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for MalithaBandara/EleGuard to start chatting
- Docker Model Runner
How to use MalithaBandara/EleGuard with Docker Model Runner:
docker model run hf.co/MalithaBandara/EleGuard:F16
- Lemonade
How to use MalithaBandara/EleGuard with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull MalithaBandara/EleGuard:F16
Run and chat with the model
lemonade run user.EleGuard-F16
List all available models
lemonade list
File size: 2,568 Bytes
459b785 6cff945 f8ceb20 7693e4c f8ceb20 7654f26 f8ceb20 a0dfa51 f8ceb20 89444a9 f8ceb20 9f7a931 f8ceb20 612f829 6cff945 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 | ---
license: mit
language:
- en
base_model:
- google/gemma-4-E2B-it
tags:
- gemma
- gguf
- multimodal
- vision
- wildlife-monitoring
- quantized
- audio
- text
---
## 🐘 EleGuard: Multimodal Elephant Detection
**EleGuard** is a specialized, multimodal Vision-Language Model (VLM) developed for the **24/7 monitoring of elephant activity** in natural habitats. By leveraging infrared (IR) imagery and bioacoustic signals, EleGuard provides a robust solution for human-elephant conflict mitigation and wildlife conservation.
## Model Summary
* **Project Name:** EleGuard
* **Base Architecture:** This model is a variant based on **Gemma 4 E2B**.
* **Modality:** Multimodal (Vision + Acoustic via Spectrograms).
* **Format:** GGUF (Optimized for edge deployment).
* **Training data:** [EleGuard Dataset](https://www.kaggle.com/datasets/malithabandara/eleguard-dataset)
* **Training Method:** Knowledge Distillation from Gemini 3.1 Flash.
## Technical Innovation: Reasoning Distillation
The core breakthrough of EleGuard is the shift from simple classification to **expert reasoning**. Instead of training only on labels, the model was fine-tuned on "thought blocks" generated by a Teacher model (Gemini 3.1 Flash).
For every image or audio sample, the model is trained to explain its reasoning—such as identifying thermal signatures in thick brush or frequency patterns in a rumble—before outputting a final status:
* **ALERT:** Elephant presence confirmed.
* **SAFE:** No threat detected.
## Dataset Details
The model was trained on a curated dataset of **2,600 samples** organized into:
* **Visual Imagery:** High-resolution daytime and **Infrared (IR)** forest captures.
* **Acoustic Data:** Mel Spectrograms identifying vocalizations like rumbles, roars, and trumpets.
* **Paired Expert Labels:** Detailed JSON reasoning files for every media asset.
## Usage & Deployment
This repository contains the model weights in **GGUF** format, specifically optimized for edge devices (Raspberry Pi, Jetson Nano, or standard laptops) using tools like `llama.cpp` or `Ollama`.
### Required Files:
1. `EleGuard-gemma-4-e2b-it.GGUF` (Main model weights)
2. `EleGuard-gemma-4-e2b-it.mmproj.GGUF` (Multimodal vision projector)
## Acknowledgments & Trademarks
* Gemma is a trademark of Google LLC.
* EleGuard is a model trained on a dataset based on Gemma 4 E2B.
* This project was developed for [The Gemma 4 Good Hackathon](https://www.kaggle.com/competitions/gemma-4-good-hackathon/overview) using the Unsloth fine-tuning framework.
--- |