CLI harness for segment-geospatial — segment satellite/aerial imagery with SAM models from the command line
Segment geospatial imagery (satellite, aerial, drone) using Meta AI's Segment Anything Model (SAM) family from the command line. Supports SAM v1, SAM 2, SAM 3, FastSAM, HQ-SAM, and LangSAM (text-based).
Requires Python >= 3.10.
pip install segment-geospatial[all]
cd agent-harness && pip install -e .
cli-anything-samgeo [--json] [--project PATH] COMMAND [ARGS...]
Global flags:
--json — Machine-readable JSON output (use this for agent consumption)--project PATH — Path to project JSON file (required for project-scoped commands)cli-anything-samgeo project new -n NAME -o PATH [-s SOURCE] [-t MODEL_TYPE] [-m MODEL_ID]
cli-anything-samgeo --project PATH project info
cli-anything-samgeo --project PATH project set-source IMAGE_PATH
cli-anything-samgeo --project PATH project history [-l LIMIT]
cli-anything-samgeo model list [-t TYPE]
cli-anything-samgeo model info MODEL_TYPE [-m MODEL_ID]
cli-anything-samgeo model check MODEL_TYPE
Model types: sam, sam2, sam3, fast_sam, hq_sam, text_sam
cli-anything-samgeo --project PATH segment automatic -o OUTPUT [--min-size N] [--max-size N]
cli-anything-samgeo --project PATH segment points -o OUTPUT -c "x1,y1;x2,y2" -l "1,0"
cli-anything-samgeo --project PATH segment boxes -o OUTPUT -b "x1,y1,x2,y2"
cli-anything-samgeo --project PATH segment text -o OUTPUT -t "buildings"
cli-anything-samgeo data info RASTER_PATH
cli-anything-samgeo data download-tiles -o OUTPUT -b "west,south,east,north" [-z ZOOM] [-s SOURCE]
cli-anything-samgeo data reproject INPUT OUTPUT [--crs EPSG:CODE]
cli-anything-samgeo data split INPUT OUT_DIR [--tile-size N] [--overlap N]
cli-anything-samgeo data basemaps [--all]
cli-anything-samgeo vector convert RASTER_MASK OUTPUT [--simplify TOLERANCE]
cli-anything-samgeo vector info VECTOR_PATH
cli-anything-samgeo vector filter INPUT OUTPUT [--min-area N] [--max-area N]
cli-anything-samgeo --project PATH export render OUTPUT [-f FORMAT] [--overwrite]
cli-anything-samgeo export formats
Formats: geotiff, cog, gpkg, shp, geojson, png
cli-anything-samgeo --project PATH session status
cli-anything-samgeo --project PATH session history [-l LIMIT]
# Download tiles
cli-anything-samgeo --json data download-tiles -o image.tif -b "-122.42,37.77,-122.40,37.79" -z 17
# Create project
cli-anything-samgeo --json project new -n urban-seg -o project.json -s image.tif -t sam2
# Run automatic segmentation
cli-anything-samgeo --json --project project.json segment automatic -o masks.tif
# Convert to GeoPackage
cli-anything-samgeo --json vector convert masks.tif buildings.gpkg --simplify 1.0
# Export as GeoJSON
cli-anything-samgeo --json --project project.json export render output.geojson -f geojson --overwrite
cli-anything-samgeo --json project new -n text-seg -o proj.json -s image.tif -t text_sam
cli-anything-samgeo --json --project proj.json segment text -o masks.tif -t "buildings"
cli-anything-samgeo --json vector convert masks.tif buildings.gpkg
--json for machine-readable output--project flag must come before the command groupmodel check TYPE before segmentingdata info to inspect rasters before processingvector convert--batch with segment automatic