explaingit

nvlabs/cbottle

Analysis updated 2026-07-06 · repo last pushed 2026-05-05

102PythonAudience · researcherComplexity · 4/5MaintainedSetup · hard

TLDR

An AI model from NVIDIA that generates realistic, high-resolution snapshots of Earth's atmosphere, like temperature, pressure, and moisture, at kilometer-scale detail.

Mindmap

mindmap
  root((repo))
    What it does
      Generates weather data
      Sharpens low detail data
      Rolls weather forward in time
    Models included
      Coarse global model
      Video version model
      Super resolution model
    Tech stack
      Python
      NVIDIA GPUs
      Earth2Studio toolkit
    Use cases
      Storm simulations
      Weather risk tools
      Fill observation gaps
    Audience
      Climate researchers
      Weather data teams
      Research labs
Click or tap to explore — scroll the page freely

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 detailed storm simulations for extreme weather research.

USE CASE 2

Produce fine-grained historical or scenario weather data for agriculture or insurance risk tools.

USE CASE 3

Sharpen coarse global climate model data down to regional, kilometer-level detail.

What is it built with?

PythonNVIDIA GPUsCUDAEarth2Studio

How does it compare?

nvlabs/cbottleclark-labs-inc/clark-browsergao-ruilin/autorun
Stars102102101
LanguagePythonPythonPython
Last pushed2026-05-05
MaintenanceMaintained
Setup difficultyhardmoderateeasy
Complexity4/55/52/5
Audienceresearcherdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires an NVIDIA GPU with CUDA support and access to the Earth2Studio toolkit for pre-trained models.

Labeled research and development only with bundled third-party software, users must check individual component licenses before use.

In plain English

cBottle is an AI model from NVIDIA that generates realistic snapshots of the Earth's atmosphere at kilometer-scale resolution. Think of it as a system that can create detailed weather and climate data, things like temperature, pressure, and moisture levels, across the globe, or take a low-resolution weather picture and fill in the fine details to make it sharp and realistic. At its core, the project uses a "diffusion" approach, which is the same family of AI techniques behind image generators. Instead of creating photos, it creates atmospheric states, grids of weather data that look like they came from real observations or physics-based simulations. The project actually includes a few different models: a coarse global model, a video version that can roll weather forward through time in multi-step sequences, and a super-resolution model that takes blurry or low-detail climate data and sharpens it. NVIDIA provides pre-trained versions of these models through their Earth2Studio toolkit, so you can start generating data without training anything from scratch. The primary audience is climate and weather researchers, or teams building applications that need high-quality atmospheric data. For example, a research lab studying extreme weather might use this to generate detailed storm simulations. A company building weather-risk tools for agriculture or insurance could use it to produce fine-grained historical or scenario data. It could also help fill gaps where real observation data is sparse, say, downscaling a coarse global climate model to regional, kilometer-level detail. A few things stand out. The project is explicitly labeled research-and-development only, not a production tool. It's built to run on NVIDIA GPUs (the inference code references CUDA directly). Training these models is resource-intensive, the training commands suggest large batch sizes and thousands of steps. The project also bundles third-party software, so anyone using it should be mindful of those licenses. The README is sparse on conceptual explanation, but the linked documentation and example notebooks fill in practical guidance for getting started.

Copy-paste prompts

Prompt 1
Help me set up NVIDIA's cbottle model to generate a high-resolution temperature snapshot of a specific region. I have access to an NVIDIA GPU and want to use the pre-trained models from Earth2Studio.
Prompt 2
I have a low-resolution global climate dataset. Walk me through using cbottle's super-resolution model to upscale it to kilometer-scale detail, including how to load my data and run inference.
Prompt 3
Show me how to use cbottle's video model to roll atmospheric weather states forward through time in multi-step sequences. I want to generate a short weather forecast animation.
Prompt 4
What hardware and setup do I need to run NVIDIA cbottle for generating atmospheric data? Explain the GPU requirements, CUDA setup, and how to get the pre-trained models.

Frequently asked questions

What is cbottle?

An AI model from NVIDIA that generates realistic, high-resolution snapshots of Earth's atmosphere, like temperature, pressure, and moisture, at kilometer-scale detail.

What language is cbottle written in?

Mainly Python. The stack also includes Python, NVIDIA GPUs, CUDA.

Is cbottle actively maintained?

Maintained — commit in last 6 months (last push 2026-05-05).

What license does cbottle use?

Labeled research and development only with bundled third-party software, users must check individual component licenses before use.

How hard is cbottle to set up?

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

Who is cbottle for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.