JeonghyeokDo commited on
Commit
5eee133
·
verified ·
1 Parent(s): b868c30

Require the Apache-2.0 Flux.2 VAE from FLUX.2-klein-base-4B

Browse files

The model card pointed users at ae.safetensors from FLUX.2-dev, whose FLUX Non-Commercial License v2.1 4(a)(iii) forbids all research and development related to surveillance. Black Forest Labs ships the same autoencoder inside FLUX.2-klein-base-4B under Apache-2.0, ungated. The two were verified identical by pairing every tensor on value (250/251 pair, worst deviation 7.802e-03 = bf16 rounding; the odd one out is a BatchNorm step counter), and in bf16 they give bit-identical latents, reconstructions and samples. GeoCore-9B is now Apache-2.0 end to end. No weight file in this repository changed.

Files changed (1) hide show
  1. README.md +29 -3
README.md CHANGED
@@ -84,7 +84,7 @@ metadata, is provided by `inference.py`:
84
  ```bash
85
  python inference.py \
86
  --ckpt /path/to/GeoCore-9B \
87
- --vae /path/to/ae.safetensors \
88
  --prompt "A satellite view of a highly dense urban city with towering skyscrapers" \
89
  --lon 126.97 --lat 37.56 --res 0.0 \
90
  --num-samples 4 --out samples/
@@ -100,8 +100,27 @@ python inference.py \
100
 
101
  ### Additional requirements
102
 
103
- The Flux.2 VAE (`ae.safetensors`, Black Forest Labs) is required to decode latents and is not
104
- included here. CLIP and T5 text encoders are downloaded from the Hub at runtime.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
105
 
106
  ## Limitations
107
 
@@ -110,6 +129,13 @@ included here. CLIP and T5 text encoders are downloaded from the Hub at runtime.
110
  * Geospatial conditioning reflects correlations in the training corpus and is not a substitute for
111
  real observations of a location.
112
 
 
 
 
 
 
 
 
113
  ## Citation
114
 
115
  ```bibtex
 
84
  ```bash
85
  python inference.py \
86
  --ckpt /path/to/GeoCore-9B \
87
+ --vae FLUX.2-klein-base-4B/vae/diffusion_pytorch_model.safetensors \
88
  --prompt "A satellite view of a highly dense urban city with towering skyscrapers" \
89
  --lon 126.97 --lat 37.56 --res 0.0 \
90
  --num-samples 4 --out samples/
 
100
 
101
  ### Additional requirements
102
 
103
+ The frozen Flux.2 VAE is required to encode and decode latents and is not included here. Use the
104
+ **Apache-2.0** copy that Black Forest Labs ships inside
105
+ [`FLUX.2-klein-base-4B`](https://huggingface.co/black-forest-labs/FLUX.2-klein-base-4B) — only the
106
+ autoencoder, not the transformer:
107
+
108
+ ```bash
109
+ huggingface-cli download black-forest-labs/FLUX.2-klein-base-4B \
110
+ vae/diffusion_pytorch_model.safetensors --local-dir FLUX.2-klein-base-4B
111
+ ```
112
+
113
+ `models/vae_flux2.py` reads that file directly (`load_autoencoder`), so no conversion step is
114
+ needed. CLIP and T5 text encoders are downloaded from the Hub at runtime.
115
+
116
+ > [!IMPORTANT]
117
+ > Do **not** substitute `ae.safetensors` from `FLUX.2-dev`. It holds the same autoencoder weights,
118
+ > but under the FLUX Non-Commercial License v2.1, whose §4(a)(iii) forbids "surveillance purposes,
119
+ > including all research and development related to surveillance" — a clause that Earth-observation
120
+ > work should not have to argue about. The Klein-4B copy is Apache-2.0 and ungated, and the two were
121
+ > verified identical by pairing every tensor on value: 250 of 251 pair one-to-one with a worst
122
+ > deviation of 7.802e-03 (bf16 rounding); the odd one out is a BatchNorm step counter. In bf16, the
123
+ > precision this model runs in, latents and reconstructions are bit-identical.
124
 
125
  ## Limitations
126
 
 
129
  * Geospatial conditioning reflects correlations in the training corpus and is not a substitute for
130
  real observations of a location.
131
 
132
+ ## License
133
+
134
+ GeoCore-9B is released under Apache-2.0, and so is every weight needed to run it: the DiT is trained
135
+ from scratch on Git-10M and is not derived from any FLUX checkpoint, and the frozen VAE is taken
136
+ from the Apache-2.0 Klein-4B release. Note that the [Git-10M](https://huggingface.co/datasets/lcybuaa/Git-10M)
137
+ training corpus is CC BY-NC-ND 4.0, which restricts (re)training on that data to non-commercial use.
138
+
139
  ## Citation
140
 
141
  ```bibtex