CoolFace
Modelpublic

kaopanboonyuen/KAO-DIFFSAT-SD-BASE-v1

sourceHugging Facecreativeml-openrail-mupdated 5mo agoView on Hugging Face
1likes20downloads
Model Card

๐Ÿ›ฐ๏ธ KAO-DIFFSAT-SD-BASE-v1

Clean Stable Diffusion Inpainting Backbone for Remote Sensing Research

๐Ÿš€ Project website: https://kaopanboonyuen.github.io/KAO/


๐Ÿ›ฐ๏ธ Visual Overview

<p align="center"> <img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reshow01.png" width="100%"> <img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reshow02.png" width="100%"> </p>

<p align="center"> <b>Satellite-oriented inpainting baseline enabling structured reconstruction across diverse geospatial scenes.</b> </p>


๐ŸŒ Overview

KAO-DIFFSAT-SD-BASE-v1 is a cleaned and structured Stable Diffusion inpainting backbone, prepared for remote sensing adaptation and research.

This repository is designed to serve as:

  • โ€”๐Ÿงฉ A baseline model for satellite image inpainting
  • โ€”๐Ÿง  A foundation for fine-tuning (KAO-DiffSat)
  • โ€”๐Ÿ”ฌ A reproducible starting point for geospatial generative AI

โš ๏ธ Important: This repository does NOT introduce new training or optimization methods. It is a clean, minimal, and research-ready version of the original inpainting model.


๐Ÿง  Positioning

ComponentDescription
This RepoClean baseline diffusion backbone
KAO-DiffSatFine-tuned satellite adaptation (future)
KAO (Paper)Optimization-based enhancement framework

๐Ÿ—๏ธ Base Model

This model is derived from:

  • โ€”https://huggingface.co/sd2-community/stable-diffusion-2-inpainting

Original model developed by Stability AI and contributors.

๐Ÿ”น What we did

  • โ€”Removed redundant files and duplicates
  • โ€”Organized model structure for clarity
  • โ€”Ensured compatibility with Diffusers
  • โ€”Prepared for downstream fine-tuning

๐Ÿ‘‰ No modification to core weights has been introduced in this release.


๐Ÿš€ Key Features

  • โ€”๐Ÿงผ Clean and minimal model structure
  • โ€”โšก Reduced storage footprint (no redundant weights)
  • โ€”๐Ÿ” Fully compatible with Diffusers pipelines
  • โ€”๐Ÿ›ฐ๏ธ Ready for remote sensing fine-tuning
  • โ€”๐Ÿงฉ Modular design for research experiments

๐Ÿ”ฌ Results Overview

<p align="center"> <img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reshow01.png" width="90%"> </p>

Qualitative reconstruction results using diffusion-based inpainting (baseline).

<p align="center"> <img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reshow02.png" width="90%"> </p>

Demonstration of spatial consistency and texture recovery.


๐Ÿ›ฐ๏ธ Full Visual Examples

<table> <tr> <td><img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reall01.png"></td> <td><img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reall02.png"></td> </tr> <tr> <td><img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reall03.png"></td> <td><img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reall04.png"></td> </tr> <tr> <td><img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reall05.png"></td> <td><img src="https://huggingface.co/kaopanboonyuen/KAO-DIFFSAT-VHR-v1/resolve/main/img/reall06.png"></td> </tr> </table>

<p align="center"> <b>Example outputs across multiple scene types.</b> </p>


โš ๏ธ What This Model Is (and Is Not)

โœ… This model:

  • โ€”A clean baseline diffusion model
  • โ€”A directly usable inpainting backbone
  • โ€”A starting point for fine-tuning and research

โŒ This model is NOT:

  • โ€”A fine-tuned satellite model
  • โ€”The KAO method
  • โ€”An optimized or domain-adapted system

๐Ÿ‘‰ Those contributions will be introduced in future releases.


๐Ÿš€ Usage (Diffusers)

python
from diffusers import StableDiffusionInpaintPipeline
import torch

pipe = StableDiffusionInpaintPipeline.from_pretrained(
    "kaopanboonyuen/KAO-DIFFSAT-SD-BASE-v1",
    torch_dtype=torch.float16
).to("cuda")

prompt = "High-resolution satellite image with missing regions reconstructed realistically"

image = pipe(
    prompt=prompt,
    image=init_image,
    mask_image=mask
).images[0]

๐Ÿ›ฐ๏ธ Prompt Guide (Satellite-Oriented Usage)

To simulate remote sensing behavior, use prompts emphasizing:

  • โ€”spatial consistency
  • โ€”structural realism
  • โ€”geospatial coherence

๐Ÿ”น Example

High-resolution satellite image of urban area,
reconstruct missing regions with realistic buildings,
maintain spatial consistency and natural textures

๐Ÿงช Use Cases

  • โ€”Cloud removal (baseline)
  • โ€”Image completion
  • โ€”Pre-training for remote sensing models
  • โ€”Generative data augmentation
  • โ€”Benchmark comparison

โš ๏ธ Limitations

  • โ€”Prompt-dependent outputs
  • โ€”Not trained on real satellite datasets
  • โ€”No geospatial constraints
  • โ€”High GPU memory usage

๐Ÿ”ฎ Roadmap

  • โ€”๐Ÿ”œ KAO-DIFFSAT-INPAINTING-v1 (fine-tuned model)
  • โ€”๐Ÿ”œ KAO-integrated optimization
  • โ€”๐Ÿ”œ Prompt-free inference system

๐Ÿ“š Citation

๐Ÿ”น Base Model

bibtex
@misc{stabilityai2022sd2,
  title        = {Stable Diffusion v2},
  author       = {{Stability AI}},
  year         = {2022},
  howpublished = {\url{https://github.com/Stability-AI/stablediffusion}},
  note         = {Including inpainting variant}
}

๐Ÿ”ฌ Project Context

This repository is part of the broader KAO-DiffSat research direction, aiming to bridge:

Diffusion Models ร— Remote Sensing ร— Optimization

๐ŸŒ Project Page

https://kaopanboonyuen.github.io/KAO/


๐Ÿค Acknowledgements

  • โ€”Stability AI for foundational diffusion models
  • โ€”Hugging Face for open model hosting
  • โ€”Open-source community for tools and infrastructure

๐ŸŒŸ Vision

This work aims to advance:

Generative AI for Earth Observation

toward scalable and research-driven geospatial intelligence systems.