{"id":50774587,"url":"https://github.com/torchgeo/terratorch","last_synced_at":"2026-06-11T22:02:45.120Z","repository":{"id":239935997,"uuid":"801016442","full_name":"torchgeo/terratorch","owner":"torchgeo","description":"A Python toolkit for fine-tuning Geospatial Foundation Models (GFMs).","archived":false,"fork":false,"pushed_at":"2026-05-29T19:41:43.000Z","size":275582,"stargazers_count":812,"open_issues_count":52,"forks_count":155,"subscribers_count":25,"default_branch":"main","last_synced_at":"2026-05-29T20:17:28.500Z","etag":null,"topics":["ai4good","ai4science","computer-vision","deep-learning","earth-observation","foundation-models","geospatial","solar-physics","weather-models"],"latest_commit_sha":null,"homepage":"https://torchgeo.github.io/terratorch/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/torchgeo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":".github/GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":".github/MAINTAINERS.md","copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-05-15T12:43:28.000Z","updated_at":"2026-05-29T18:29:48.000Z","dependencies_parsed_at":"2025-01-02T19:27:33.691Z","dependency_job_id":"3861adb8-1ae3-4c8e-bfa0-3d7555f61647","html_url":"https://github.com/torchgeo/terratorch","commit_stats":null,"previous_names":["ibm/terratorch","terrastackai/terratorch","torchgeo/terratorch"],"tags_count":47,"template":false,"template_full_name":null,"purl":"pkg:github/torchgeo/terratorch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torchgeo%2Fterratorch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torchgeo%2Fterratorch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torchgeo%2Fterratorch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torchgeo%2Fterratorch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/torchgeo","download_url":"https://codeload.github.com/torchgeo/terratorch/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torchgeo%2Fterratorch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34219510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai4good","ai4science","computer-vision","deep-learning","earth-observation","foundation-models","geospatial","solar-physics","weather-models"],"created_at":"2026-06-11T22:02:44.173Z","updated_at":"2026-06-11T22:02:45.112Z","avatar_url":"https://github.com/torchgeo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!---\n\u003cimg src=\"https://github.com/user-attachments/assets/f7c9586f-6220-4a53-9669-2aee3300b492#light-only\" alt=\"TerraTorch\"  width=\"400\"/\u003e\n\u003cimg src=\"assets/logo_white.png#dark-only\" alt=\"TerraTorch\"  width=\"400\"/\u003e\n--\u003e\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://github.com/user-attachments/assets/f8c9586f-6220-4a53-9669-2aee3300b492\"\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets/logo_white.png\"\u003e\n  \u003ccenter\u003e\u003cimg style=\"display: block; margin-left: auto; margin-right: auto\"; src=\"https://github.com/user-attachments/assets/f7c9586f-6220-4a53-9669-2aee3300b492\" alt=\"TerraTorch\"  width=\"400\"/\u003e\u003c/center\u003e\n\u003c/picture\u003e\n\n\u003c!--\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/figs/logo_inv.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"docs/figs/logo.png\"\u003e\n\u003c/picture\u003e\n--\u003e\n\n[![huggingface](https://img.shields.io/badge/Hugging_Face-join-FFD21E?logo=huggingface)](https://huggingface.co/ibm-nasa-geospatial)\n[![pypi](https://badge.fury.io/py/terratorch.svg)](https://pypi.org/project/terratorch)\n[![tests](https://github.com/torchgeo/terratorch/actions/workflows/tests.yaml/badge.svg)](https://github.com/torchgeo/terratorch/actions/workflows/tests.yaml)\n[![MkDocs](https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs\u0026logoColor=fff)](https://torchgeo.github.io/terratorch/)\n\u003c!--\n![cov](https://github.com/torchgeo/terratorch/raw/main/assets/coverage-badge.svg)\n--\u003e\n[![PyPI Downloads](https://img.shields.io/pypi/dm/terratorch.svg?label=PyPI%20downloads)](https://pypi.org/project/terratorch/)\n[![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/terratorch.svg?label=Conda%20downloads)](https://anaconda.org/conda-forge/terratorch)\n\nPlease read the contribution guidelines (see `Contribution` below) if you want to contribute to\nTerraTorch.\n\n## Overview\nTerraTorch is a PyTorch domain library based on [PyTorch Lightning](https://lightning.ai/docs/pytorch/stable/) and the [TorchGeo](https://github.com/microsoft/torchgeo) domain library\nfor geospatial data. \n\nPlease also try our HPO/NAS tool: [Iterate](https://github.com/terrastackai/iterate)\n\n## Disclaimer\nTerraTorch provides tools for fine-tuning and using pretrained models.\nNo models are hosted by TerraTorch. TerraTorch only provides the training and inference framework.  \n\nUser responsibility: It is the sole responsibility of the user to verify that the license of any model they download, fine-tune, or deploy allows their intended use.\nThe TerraTorch maintainers do not provide legal advice and are not liable for any misuse of third-party models.\n\n\u003chr\u003e\n\u003ca href=\"https://youtu.be/LNKovSef5lU\"\u003e\n  \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/4/42/YouTube_icon_%282013-2017%29.png\" alt=\"YouTube\" width=\"20\"\u003e\n  Video: Introduction to TerraTorch\n  \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/4/42/YouTube_icon_%282013-2017%29.png\" alt=\"YouTube\" width=\"20\"\u003e\n\u003c/a\u003e\n\u003chr\u003e\n\n\nTerraTorch’s main purpose is to provide a flexible fine-tuning framework for Geospatial Foundation Models, which can be interacted with at different abstraction levels. The library provides:\n\n- Convenient modelling tools:\n    - Flexible trainers for Image Segmentation, Classification and Pixel Wise Regression fine-tuning tasks\n    - Model factories that allow to easily combine backbones and decoders for different tasks\n    - Ready-to-go datasets and datamodules that require only to point to your data with no need of creating new custom classes\n    - Launching of fine-tuning tasks through CLI and flexible configuration files, or via jupyter notebooks\n- Easy access to:\n    - Open source pre-trained Geospatial Foundation Model backbones:\n      * [Prithvi](https://huggingface.co/ibm-nasa-geospatial/Prithvi-100M)\n      * [TerraMind](https://research.ibm.com/blog/terramind-esa-earth-observation-model)\n      * [SatMAE](https://sustainlab-group.github.io/SatMAE/)\n      * [ScaleMAE](https://github.com/bair-climate-initiative/scale-mae)\n      * Satlas (as implemented in [TorchGeo](https://github.com/microsoft/torchgeo))\n      * DOFA (as implemented in [TorchGeo](https://github.com/microsoft/torchgeo))\n      * SSL4EO-L and SSL4EO-S12 models (as implemented in [TorchGeo](https://github.com/microsoft/torchgeo))\n      * [Clay](https://github.com/Clay-foundation/model)\n    - Backbones available in the [timm](https://github.com/huggingface/pytorch-image-models) (Pytorch image models)\n    - Decoders available in [SMP](https://github.com/qubvel/segmentation_models.pytorch) (Pytorch Segmentation models with pre-training backbones) and [mmsegmentation](https://github.com/open-mmlab/mmsegmentation) packages\n    - Fine-tuned models such as [granite-geospatial-biomass](https://huggingface.co/ibm-granite/granite-geospatial-biomass)\n    - All GEO-Bench datasets and datamodules\n    - All [TorchGeo](https://github.com/microsoft/torchgeo) datasets and datamodules \n\n## Installation\n\n### Pip\nIn order to use the file `pyproject.toml` it is necessary to guarantee `pip\u003e=21.8`. If necessary upgrade `pip` using `python -m pip install --upgrade pip`. \n\nFor a stable point-release, use `pip install terratorch==\u003cversion\u003e`.\n\n[comment]: \u003cIf you prefer to get the most recent version of the main branch, install the library with `pip install git+https://github.com/torchgeo/terratorch.git`.\u003e\nTo get the most recent version of the branch `main`, install the library with `pip install git+https://github.com/torchgeo/terratorch.git`.\n\n### Conda\nTerraTorch is also available on `conda-forge`, to install from there do `conda install -c conda-forge terratorch`. \n\n### Pipx\nAlternatively, it is possible to install using [pipx](https://github.com/pypa/pipx) via `pipx install terratorch`, which creates an isolated environment and allows the user to run the application as a common CLI tool, with no need of installing dependencies or activating environments.\n\n### Gdal\nTerraTorch requires gdal to be installed, which can be quite a complex process.\nIf you don't have GDAL set up on your system, we recommend using a conda\nenvironment and installing it with `conda install -c conda-forge gdal`. If you\nare installing from `conda-forge` it probably won't be a problem. \n\n### Install as a developer\nTo install as a developer (e.g. to extend the library):\n```\ngit clone https://github.com/torchgeo/terratorch.git\ncd terratorch\npip install -e .[test]\n```\n\n### Optional Dependencies\n\nTerraTorch supports several optional features that can be installed separately:\n\n- **VLLM support**: `pip install terratorch[vllm]`\n- **Weather Foundation Models**: `pip install terratorch[wxc]` (Python \u003e= 3.11 only)\n- **PEFT (Parameter-Efficient Fine-Tuning)**: `pip install terratorch[peft]`\n- **Visualization tools**: `pip install terratorch[visualize]`\n- **GeoBench v2**: `pip install terratorch[geobenchv2]`\n- **Logging with Weights \u0026 Biases**: `pip install terratorch[logging]`\n- **MMSegmentation support**: `pip install terratorch[mmseg]`\n- **Surya support**: `pip install terratorch[surya]`\n- **Tortilla file support**: `pip install terratorch[tortilla]` - Required for loading datasets from tortilla files\n\nYou can install multiple optional dependencies at once: `pip install terratorch[vllm,peft,logging]`\n\n## Documentation\n\nTo get started, check out the [quick start guide](https://torchgeo.github.io/terratorch/quick_start).\n\nDevelopers, check out the [architecture overview](https://torchgeo.github.io/terratorch/architecture).\n\n\n[TerraTorch: The Geospatial Foundation Models Toolkit on arXiv](https://arxiv.org/abs/2503.20563)\n## Contributing\n\nThis project welcomes contributions and suggestions. Ways to contribute or get involved:\n\n- Join our [Discord](https://discord.gg/vQXTNmrkTM)\n- Create an [Issue](https://github.com/torchgeo/terratorch/issues) (for bugs or feature requests)\n- Contribute via [PR](https://github.com/torchgeo/terratorch/pulls)\n- Join our [duoweekly](https://romeokienzler.medium.com/the-duoweekly-manifesto-eaa6c1f542c8) community calls taking place [Tuesdays 4:30 PM - 5 PM CEST](https://teams.microsoft.com/l/meetup-join/19%3ameeting_MWJhMThhMTMtMjc3MS00YjAyLWI3NTMtYTI0NDQ3NWY3ZGU2%40thread.v2/0?context=%7b%22Tid%22%3a%22fcf67057-50c9-4ad4-98f3-ffca64add9e9%22%2c%22Oid%22%3a%227f7ab87a-680c-4c93-acc5-fbd7ec80823a%22%7d) and [Thursdays 2:30 PM - 3 PM CEST](https://teams.microsoft.com/l/meetup-join/19%3ameeting_MWJhMThhMTMtMjc3MS00YjAyLWI3NTMtYTI0NDQ3NWY3ZGU2%40thread.v2/0?context=%7b%22Tid%22%3a%22fcf67057-50c9-4ad4-98f3-ffca64add9e9%22%2c%22Oid%22%3a%227f7ab87a-680c-4c93-acc5-fbd7ec80823a%22%7d).\n\nYou can find more detailed contribution guidelines [here](https://torchgeo.github.io/terratorch/stable/contributing/). \n\nIf you want to meet the GitHub DCO checks, you **need** to do your commits as below:\n```\ngit commit -s -m \u003cmessage\u003e\n```\nIt will sign the commit with your ID and the check will be met. \n\n## Credits\n\n\u003cimg src=\"assets/embed2scale_logo.svg\"\n   alt=\"Embed2Scale\"\n   height=\"62\"\n   style=\"vertical-align: middle; margin-right: 6px;\" /\u003e\n\u003cstrong\u003eEmbed2Scale.\u003c/strong\u003e\nThe embedding workflow integration and maintenance in TerraTorch are carried out as part of the Embed2Scale project\n(Earth Observation \u0026 Weather Data Federation with AI Embeddings), funded by the EU’s Horizon Europe programme\n(Grant Agreement No. 101131841), with additional support from SERI and UKRI.\n\n\n## License\n\nThis project is primarily licensed under the **Apache License 2.0**. \n\nHowever, some files contain code licensed under the **MIT License**. These files are explicitly listed in [`MIT_FILES.txt`](./MIT_FILES.txt).\n\nBy contributing to this repository, you agree that your contributions will be licensed under the Apache 2.0 License unless otherwise stated.\n\nFor more details, see the [LICENSE](./LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorchgeo%2Fterratorch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftorchgeo%2Fterratorch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorchgeo%2Fterratorch/lists"}