Rewrite model card in plain language

README.md

@@ -16,9 +16,9 @@ tags:
 
 # SolPix
 
-SolPix is a roughly 49M-parameter text-to-image flow transformer. It generates latents for the SANA 1.1 DC-AE, with text conditioning from Flan-T5 Base.
+SolPix generates images from text with a flow transformer of roughly 49M parameters. The transformer works in the latent space of the SANA 1.1 DC-AE, and Flan-T5 Base encodes the prompt. The included helper produces 512x512 images.
 
-## Model
+## Generator and encoders
 
 | Setting | Value |
 |---|---|
@@ -38,18 +38,18 @@ SolPix is a roughly 49M-parameter text-to-image flow transformer. It generates l
 | Saved optimizer step | 210,000 |
 | Configured training schedule | 5,000,000 steps |
 
-The text encoder and autoencoder are external dependencies and are excluded from the generator's parameter count. `SolPixTransformer2D` predicts latent velocity; `AutoencoderDCSol` loads the matching Diffusers `AutoencoderDC` to decode sampled latents.
+The 49M count covers the generator. It excludes the frozen text encoder and autoencoder, which are separate dependencies. `SolPixTransformer2D` predicts latent velocity, and `AutoencoderDCSol` loads the matching Diffusers `AutoencoderDC` to decode the sampled latents.
 
-## Use
+## Generate an image
 
-Download this repository and install its requirements:
+Download this repository and install `requirements.txt`, then run the helper with a prompt:
 
 ```bash
 python -m pip install -r requirements.txt
 python generate.py --prompt "A glass greenhouse in a quiet garden after rain" --output solpix.png
 ```
 
-To choose a local checkpoint, seed, and sampling settings:
+You can also set the local checkpoint, seed, and sampling settings:
 
 ```bash
 python generate.py \
@@ -59,144 +59,142 @@ python generate.py \
   --output ./solpix.png
 ```
 
-The helper downloads Flan-T5 Base and the pinned SANA DC-AE revision, then samples with Euler integration and classifier-free guidance. It produces a 512x512 image and uses CUDA when available. CPU inference is supported but slow.
+The helper downloads Flan-T5 Base and the pinned SANA DC-AE revision. It samples with Euler integration and classifier-free guidance, using CUDA if available. CPU inference works but is slow.
 
-Sampling follows `x_t = (1 - t) x_clean + t noise`, integrating from `t=1` to `t=0`. Encoder and decoder identifiers and revisions are in `config.json`.
+The flow path is `x_t = (1 - t) x_clean + t noise`; sampling integrates from `t=1` to `t=0`. `config.json` records the encoder and decoder identifiers and their revisions.
 
-## Training
+## Training data and run
 
-The split was curated from [MONET v1.2.0](https://huggingface.co/datasets/jasperai/monet) with seed `20260924`: 174,603 training examples and a 9,300-example validation holdout. Training used pre-encoded SANA F32C32 latents and Flan-T5 Base caption states.
+The data split comes from [MONET v1.2.0](https://huggingface.co/datasets/jasperai/monet), curated with seed `20260924`. It has 174,603 training examples and a validation holdout of 9,300 examples. Training used pre-encoded SANA F32C32 image latents and Flan-T5 Base caption states.
 
-Sources included CC12M, CommonCatalog-CC-BY, COYO, Diffusion-Aesthetic-4K, LAION, and synthetic captions from Flux Klein, Flux Schnell, and Z-Image. Curation applied resolution, aesthetic, NSFW, watermark, and near-duplicate filters. Source records carried CC BY 4.0, Apache 2.0, Google permissive, and MIT license labels. Those labels describe upstream records, not a new license for their contents. Images and dataset shards are not redistributed here.
+The sources include CC12M and CommonCatalog-CC-BY, COYO, Diffusion-Aesthetic-4K, and LAION. Synthetic captions come from Flux Klein, Flux Schnell, and Z-Image. Curation filters cover resolution and aesthetics, NSFW content, watermarks, and near duplicates.
 
-The Windows v1.0 continuation used BF16 on one RTX 3080 Ti, with batch size 4 and gradient accumulation 16. The published checkpoint is step 210,000. The documented 1.1 continuation uses the same split and targets step 300,000.
+Upstream records carry CC BY 4.0, Apache 2.0, Google permissive, and MIT license labels. Those labels describe the source records; they don't grant a new license for the contents. This repository doesn't redistribute the images or dataset shards.
 
-## Evaluation and limits
+The Windows v1.0 continuation ran in BF16 on one RTX 3080 Ti, with batch size 4 and gradient accumulation 16. The released checkpoint is step 210,000. The documented 1.1 continuation keeps the same split and targets step 300,000.
 
-No formal image-quality or prompt-following benchmark accompanies this checkpoint. The gallery shows generated outputs, not a held-out quality estimate. Expect composition errors, artifacts, and weak rendering of text or fine detail.
+## Results and limits
 
-The model has no built-in safety classifier. Dataset filtering does not remove all source biases or unwanted associations. Flan-T5 and SANA DC-AE have their own licenses and usage terms.
+The released checkpoint has no formal image-quality or prompt-following benchmark. The gallery lets you inspect generated outputs, but it doesn't provide a held-out quality estimate. Expect composition errors and artifacts, with weak rendering of text or fine detail.
 
-## Samples
+SolPix has no built-in safety classifier. Filtering the training data doesn't remove all source biases or unwanted associations. Flan-T5 and SANA DC-AE also have their own licenses and usage terms.
 
+## Generated samples
 
-These are 15 individual images generated by the released SolPix checkpoint, not external examples. Each was sampled at 512×512 with 32 Euler steps and guidance scale 3.5 using the pinned SANA DC-AE decoder. The image files, prompts, seeds, and SHA-256 values are in `samples/`.
+These 15 images come from the released SolPix checkpoint. Each uses 512×512 resolution, 32 Euler steps, and guidance scale 3.5 with the pinned SANA DC-AE decoder. `samples/` contains the image files and records their prompts, seeds, and SHA-256 values.
 
 ### Sample 01
 
 ![SolPix sample 01 - Three Black men sharing french fries at a neighborhood diner, candid documentary photography.](samples/sample_01.png)
 
-**Prompt:** Three Black men sharing french fries at a neighborhood diner, candid documentary photography.  
+Prompt: Three Black men sharing french fries at a neighborhood diner, candid documentary photography.  
 Seed: 260926
 
 ### Sample 02
 
 ![SolPix sample 02 - A red fox standing in fresh snow beneath pine trees at winter dawn, wildlife photography.](samples/sample_02.png)
 
-**Prompt:** A red fox standing in fresh snow beneath pine trees at winter dawn, wildlife photography.  
+Prompt: A red fox standing in fresh snow beneath pine trees at winter dawn, wildlife photography.  
 Seed: 260927
 
 ### Sample 03
 
 ![SolPix sample 03 - A glass greenhouse filled with ferns after rain, soft natural light, botanical photograph.](samples/sample_03.png)
 
-**Prompt:** A glass greenhouse filled with ferns after rain, soft natural light, botanical photograph.  
+Prompt: A glass greenhouse filled with ferns after rain, soft natural light, botanical photograph.  
 Seed: 260928
 
 ### Sample 04
 
 ![SolPix sample 04 - A handmade cobalt blue teapot on a pale stone table, clean studio product photograph.](samples/sample_04.png)
 
-**Prompt:** A handmade cobalt blue teapot on a pale stone table, clean studio product photograph.  
+Prompt: A handmade cobalt blue teapot on a pale stone table, clean studio product photograph.  
 Seed: 260929
 
 ### Sample 05
 
 ![SolPix sample 05 - A white sailboat crossing a calm blue bay at golden hour, fine art landscape photograph.](samples/sample_05.png)
 
-**Prompt:** A white sailboat crossing a calm blue bay at golden hour, fine art landscape photograph.  
+Prompt: A white sailboat crossing a calm blue bay at golden hour, fine art landscape photograph.  
 Seed: 260930
 
 ### Sample 06
 
 ![SolPix sample 06 - An orange cat curled on a wooden chair in a sunlit bookshop, cozy editorial photograph.](samples/sample_06.png)
 
-**Prompt:** An orange cat curled on a wooden chair in a sunlit bookshop, cozy editorial photograph.  
+Prompt: An orange cat curled on a wooden chair in a sunlit bookshop, cozy editorial photograph.  
 Seed: 260931
 
 ### Sample 07
 
 ![SolPix sample 07 - A small street cafe reflected in wet pavement at night, warm window light, city photograph.](samples/sample_07.png)
 
-**Prompt:** A small street cafe reflected in wet pavement at night, warm window light, city photograph.  
+Prompt: A small street cafe reflected in wet pavement at night, warm window light, city photograph.  
 Seed: 260932
 
 ### Sample 08
 
 ![SolPix sample 08 - A wooden lighthouse on a rocky coast under a cloudy sky, atmospheric landscape photograph.](samples/sample_08.png)
 
-**Prompt:** A wooden lighthouse on a rocky coast under a cloudy sky, atmospheric landscape photograph.  
+Prompt: A wooden lighthouse on a rocky coast under a cloudy sky, atmospheric landscape photograph.  
 Seed: 260933
 
 ### Sample 09
 
 ![SolPix sample 09 - A bowl of ripe peaches on a kitchen counter, morning light, natural still life photograph.](samples/sample_09.png)
 
-**Prompt:** A bowl of ripe peaches on a kitchen counter, morning light, natural still life photograph.  
+Prompt: A bowl of ripe peaches on a kitchen counter, morning light, natural still life photograph.  
 Seed: 260934
 
 ### Sample 10
 
 ![SolPix sample 10 - A snow-covered cabin among tall pine trees at blue hour, quiet winter landscape photograph.](samples/sample_10.png)
 
-**Prompt:** A snow-covered cabin among tall pine trees at blue hour, quiet winter landscape photograph.  
+Prompt: A snow-covered cabin among tall pine trees at blue hour, quiet winter landscape photograph.  
 Seed: 260935
 
 ### Sample 11
 
 ![SolPix sample 11 - A baker placing fresh bread on a cooling rack in a bright kitchen, documentary photograph.](samples/sample_11.png)
 
-**Prompt:** A baker placing fresh bread on a cooling rack in a bright kitchen, documentary photograph.  
+Prompt: A baker placing fresh bread on a cooling rack in a bright kitchen, documentary photograph.  
 Seed: 260936
 
 ### Sample 12
 
 ![SolPix sample 12 - A goldfinch perched on a thin branch among spring blossoms, close-up wildlife photograph.](samples/sample_12.png)
 
-**Prompt:** A goldfinch perched on a thin branch among spring blossoms, close-up wildlife photograph.  
+Prompt: A goldfinch perched on a thin branch among spring blossoms, close-up wildlife photograph.  
 Seed: 260937
 
 ### Sample 13
 
 ![SolPix sample 13 - A red bicycle leaning against a brick wall on a leafy neighborhood street, lifestyle photograph.](samples/sample_13.png)
 
-**Prompt:** A red bicycle leaning against a brick wall on a leafy neighborhood street, lifestyle photograph.  
+Prompt: A red bicycle leaning against a brick wall on a leafy neighborhood street, lifestyle photograph.  
 Seed: 260938
 
 ### Sample 14
 
 ![SolPix sample 14 - A lemon cake with a slice cut out on a ceramic plate, bright tabletop food photograph.](samples/sample_14.png)
 
-**Prompt:** A lemon cake with a slice cut out on a ceramic plate, bright tabletop food photograph.  
+Prompt: A lemon cake with a slice cut out on a ceramic plate, bright tabletop food photograph.  
 Seed: 260939
 
 ### Sample 15
 
 ![SolPix sample 15 - A small observatory beneath a clear star-filled sky, distant mountains, night landscape photograph.](samples/sample_15.png)
 
-**Prompt:** A small observatory beneath a clear star-filled sky, distant mountains, night landscape photograph.  
+Prompt: A small observatory beneath a clear star-filled sky, distant mountains, night landscape photograph.  
 Seed: 260940
 
+## Repository files
 
-## Files
-
-- `step_00210000.pt`: EMA and raw weights, optimizer state, configuration, and training arguments.
-- `solpix/`: transformer, decoder adapter, configuration, data, and training components.
-- `generate.py`: prompt-to-image helper.
-- `train.py` and `sample_latents.py`: training and latent-sampling entry points.
-- `samples/`: 15 generated PNGs and their metadata.
-- `config.json`: architecture and external-model manifest.
+- `step_00210000.pt` contains EMA and raw weights, optimizer state, configuration, and training arguments.
+- `solpix/` has the transformer and decoder adapter, along with configuration, data, and training components.
+- `generate.py` turns a prompt into an image. `train.py` and `sample_latents.py` are the training and latent-sampling entry points.
+- `samples/` holds the 15 generated PNGs and their metadata. `config.json` records the architecture and external-model manifest.
 
 ## License
 
-Repository code, checkpoint weights, configuration, card, and supplied banner are licensed under [Apache 2.0](LICENSE). See [NOTICE](NOTICE) for attribution. This license does not relicense the upstream datasets, Flan-T5, or SANA DC-AE.
+[Apache 2.0](LICENSE) covers the repository code and checkpoint weights, as well as the configuration, card, and supplied banner. [NOTICE](NOTICE) contains the attribution. The upstream datasets, Flan-T5, and SANA DC-AE keep their own licenses.