Instructions to use glody007/zamba-deforestation-detector with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use glody007/zamba-deforestation-detector with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="glody007/zamba-deforestation-detector", filename="mmproj-zamba-deforestation-v2-Q8_0.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 glody007/zamba-deforestation-detector with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf glody007/zamba-deforestation-detector:Q8_0 # Run inference directly in the terminal: llama-cli -hf glody007/zamba-deforestation-detector:Q8_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf glody007/zamba-deforestation-detector:Q8_0 # Run inference directly in the terminal: llama-cli -hf glody007/zamba-deforestation-detector:Q8_0
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 glody007/zamba-deforestation-detector:Q8_0 # Run inference directly in the terminal: ./llama-cli -hf glody007/zamba-deforestation-detector:Q8_0
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 glody007/zamba-deforestation-detector:Q8_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf glody007/zamba-deforestation-detector:Q8_0
Use Docker
docker model run hf.co/glody007/zamba-deforestation-detector:Q8_0
- LM Studio
- Jan
- Ollama
How to use glody007/zamba-deforestation-detector with Ollama:
ollama run hf.co/glody007/zamba-deforestation-detector:Q8_0
- Unsloth Studio new
How to use glody007/zamba-deforestation-detector 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 glody007/zamba-deforestation-detector 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 glody007/zamba-deforestation-detector to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for glody007/zamba-deforestation-detector to start chatting
- Pi new
How to use glody007/zamba-deforestation-detector with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf glody007/zamba-deforestation-detector:Q8_0
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "glody007/zamba-deforestation-detector:Q8_0" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use glody007/zamba-deforestation-detector with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf glody007/zamba-deforestation-detector:Q8_0
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default glody007/zamba-deforestation-detector:Q8_0
Run Hermes
hermes
- Docker Model Runner
How to use glody007/zamba-deforestation-detector with Docker Model Runner:
docker model run hf.co/glody007/zamba-deforestation-detector:Q8_0
- Lemonade
How to use glody007/zamba-deforestation-detector with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull glody007/zamba-deforestation-detector:Q8_0
Run and chat with the model
lemonade run user.zamba-deforestation-detector-Q8_0
List all available models
lemonade list
Install from WinGet (Windows)
winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama-server -hf glody007/zamba-deforestation-detector:Q8_0# Run inference directly in the terminal:
llama-cli -hf glody007/zamba-deforestation-detector:Q8_0Use 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 glody007/zamba-deforestation-detector:Q8_0# Run inference directly in the terminal:
./llama-cli -hf glody007/zamba-deforestation-detector:Q8_0Build 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 glody007/zamba-deforestation-detector:Q8_0# Run inference directly in the terminal:
./build/bin/llama-cli -hf glody007/zamba-deforestation-detector:Q8_0Use Docker
docker model run hf.co/glody007/zamba-deforestation-detector:Q8_0zamba-deforestation-detector โ LFM2.5-VL-450M (GGUF)
Fine-tuned from LiquidAI/LFM2.5-VL-450M
on simulated Sentinel-2 RGB+SWIR change-detection pairs over the Congo
Basin (DRC), to flag near-real-time forest clearing on a 90-day window.
Companion to the zamba-sat
repo, built for the AI in Space hackathon (DPhi Space ร Liquid AI).
Given four images per sample โ RGB(t-1), SWIR(t-1), RGB(t-0), SWIR(t-0) โ and a small text block (lat/lon, dates, region name), the model emits a chain-of-thought followed by a JSON change-detection record:
{
"deforestation_detected": true,
"change_pattern": "expansion", // expansion | stable | cloud_artifact
"trajectory_confidence": "medium", // low | medium | high
"severity": "medium", // none | low | medium | high
"clearing_type": "small_holder",
"area_bucket_t1": "1-5_ha",
"area_bucket_t0": "0-1_ha",
"active_operation": false,
"active_machinery_visible": false,
"smoke_or_fire_visible": false,
"recent_road_construction": false,
"frame_quality": ["good"]
}
The full XML chain-of-thought wraps the JSON with <frame_descriptions>,
<change_analysis>, <final_pattern>, and <json> blocks โ see the
zamba-sat README
for the schema.
Eval results
Evaluated on the held-out subset of the
glody007/zamba-sat-congo-deforestation
dataset (90-day window, wide_window + wide_window_v2 runs). Ground
truth from claude-opus-4-7.
| field | LFM2.5-VL-450M (base, Q8_0) | LFM2.5-VL-450M Q8_0 (fine-tuned, this model) |
|---|---|---|
| valid_json | 0% | 67% |
| change_pattern (expansion / stable / cloud_artifact) | 0% | 50% |
| trajectory_confidence | 0% | 67% |
| composite (13 fields) | 0.0% | 38.5% |
Held-out test set is small (N=6) โ the headline movement is the base model emitting placeholder prose vs the fine-tune emitting schema-compliant JSON with correct expansion/stable discrimination. The base-model 0% is on the dir-test (N=36); see zamba-sat/evals/EXPERIMENTS.md for the full experiment log including v1 (cloud-class collapse) and v3 (overfitting boundary).
Files
Running inference with a VLM in llama.cpp requires two GGUF files:
| file | description |
|---|---|
zamba-deforestation-v2-Q8_0.gguf |
Language model backbone (Q8_0) |
mmproj-zamba-deforestation-v2-Q8_0.gguf |
Vision tower + multimodal projector (F16) |
Usage
llama-server
llama-server \
-m zamba-deforestation-v2-Q8_0.gguf \
--mmproj mmproj-zamba-deforestation-v2-Q8_0.gguf \
--jinja --port 8000
Reproduce eval results
Clone zamba-sat and run:
git clone https://github.com/glody007/zamba-sat
cd zamba-sat
uv sync
# (1) Re-prep the dataset locally โ same stratified split used for training.
uv run scripts/prepare_finetune.py \
--runs wide_window wide_window_v2 \
--output data/finetune \
--skip-clouds
# (2) Eval the fine-tune behind llama-server (started in another shell with
# the GGUFs from this repo).
uv run scripts/evaluate.py --backend local \
--server-url http://localhost:8000 \
--model zamba-deforestation-Q8_0 \
--runs wide_window wide_window_v2 --split test \
--splits-file data/finetune/splits.json
Training details
- Base:
LiquidAI/LFM2.5-VL-450M - Method: full SFT (no LoRA), via
leap-finetuneon Modal H100ร1 - Data: 24 stratified train rows after
--skip-clouds(17 expansion + 7 stable); held-out test = 6 rows (4 expansion + 2 stable) - Hyperparameters: 5 effective epochs / 12 grad steps,
effective batch size 8 (2 ร 4 grad accum), LR
2e-5, cosine, warmup 0.03, seed 42
This is the v2 checkpoint, which on internal evals beat both v1
(cloud-class collapse from training without --skip-clouds) and v3
(overfit at 8 ep / ~25 grad steps). v2 is the apparent sweet spot given
the dataset size; the next step before further training is to collect
more stable labels.
- Downloads last month
- 77
8-bit
Model tree for glody007/zamba-deforestation-detector
Base model
LiquidAI/LFM2.5-350M-Base
Install from brew
# Start a local OpenAI-compatible server with a web UI: llama-server -hf glody007/zamba-deforestation-detector:Q8_0# Run inference directly in the terminal: llama-cli -hf glody007/zamba-deforestation-detector:Q8_0