whatisgithub

What is zamba-sat?

glody007/zamba-sat — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A Python pipeline that generates labeled Congo Basin deforestation data from paired Sentinel-2 satellite images, using an oracle AI model to produce structured change labels.

Mindmap

mindmap
  root((zamba-sat))
    Data Pipeline
      Sentinel-2 Fetch
      RGB and SWIR Frames
      Spatial Temporal Sampling
    Labeling
      Oracle VLM
      XML Chain of Thought
      Pydantic Validation
    Labels
      Stable
      Expansion
      Cloud Artifact
    Output
      Hugging Face Dataset
      On-board VLM Fine-tuning

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a labeled dataset of satellite image pairs showing deforestation, expansion, or stable forest for training a vision language model.

USE CASE 2

Fine-tune a small vision language model to detect land cover change from paired RGB and SWIR satellite frames.

USE CASE 3

Study the published Hugging Face dataset of Congo Basin deforestation labels for environmental monitoring research.

USE CASE 4

Use the structured XML chain-of-thought prompting pattern as a template for getting reliable structured labels from a larger oracle model.

What is it built with?

PythonSentinel-2ClaudePydanticHugging Face

How does it compare?

glody007/zamba-sat0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyhardmoderatehard
Complexity5/54/51/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires access to the SimSat Sentinel-2 data source and an oracle vision-language model API for generating labels.

So what is it?

Zamba-sat is a data generation and labeling pipeline for detecting deforestation in the Congo Basin using satellite imagery, built for the AI in Space hackathon run by DPhi Space and Liquid AI. It is written in Python. The Congo Basin is the second largest tropical rainforest on Earth and a major carbon sink, but it faces ongoing pressure from logging road expansion, slash and burn agriculture, artisanal mining, and infrastructure encroachment near park boundaries. Manual satellite review does not scale to the size of the area or the revisit schedule needed to catch new clearings while they are still small enough to act on. The goal of this project is to train a compact vision language model that could eventually run directly on a satellite, targeting a small model called Liquid LFM2.5-VL-450M, so that only the relevant frames and labels need to be sent down to the ground instead of full imagery. The pipeline fetches pairs of Sentinel-2 satellite images taken roughly 90 days apart from fixed Congo Basin sites. For each location it retrieves four frames: two natural color images and two SWIR, or short wave infrared, images, one set from the past and one from the current period. SWIR reveals vegetation moisture and bare ground that is hard to tell apart in ordinary visible light, especially under haze. A larger oracle vision language model, Claude Opus, reads the four frames and returns a structured chain of thought response using labeled XML sections rather than plain JSON, describing each frame, analyzing what changed, and assigning a final label. A Pydantic schema validates each response before it is accepted. The possible labels are stable, clearing, expansion, regrowth, or cloud artifact, with the cloud artifact label used deliberately when cloud cover makes a judgment unsafe to make. The resulting labeled dataset has 72 samples across three sites in the Democratic Republic of Congo, Yangambi, Kindu, and Lusambo, and is published publicly on Hugging Face for others to use.

Copy-paste prompts

Prompt 1
I want an oracle AI model to label satellite image pairs with a structured reasoning trace before giving a final classification. Show me how to design an XML tagged chain-of-thought prompt for this.
Prompt 2
Explain the difference between RGB and SWIR satellite bands and why SWIR helps detect vegetation change under cloud haze.
Prompt 3
How would I validate an AI model's structured JSON output against a Pydantic schema and reject responses that do not conform?
Prompt 4
I need to sample satellite image locations on a spatial grid with a temporal train/test split that avoids data leakage between nearby revisit dates. How should I design that sampling logic?
Prompt 5
Show me how to publish a labeled image dataset with metadata to Hugging Face using the datasets library.

Frequently asked questions

What is zamba-sat?

A Python pipeline that generates labeled Congo Basin deforestation data from paired Sentinel-2 satellite images, using an oracle AI model to produce structured change labels.

What language is zamba-sat written in?

Mainly Python. The stack also includes Python, Sentinel-2, Claude.

How hard is zamba-sat to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is zamba-sat for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.