Instructions to use CIawevy/Flux.1-dev-TextPecker-SQPA with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use CIawevy/Flux.1-dev-TextPecker-SQPA with PEFT:
Task type is invalid.
- Diffusers
How to use CIawevy/Flux.1-dev-TextPecker-SQPA with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("black-forest-labs/FLUX.1-dev", dtype=torch.bfloat16, device_map="cuda") pipe.load_lora_weights("CIawevy/Flux.1-dev-TextPecker-SQPA") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Inference
- Notebooks
- Google Colab
- Kaggle
Improve model card: add metadata, license, and link to paper (#1)
Browse files- Improve model card: add metadata, license, and link to paper (023a67af9a8f0bbe318d059d64f6e6191ec6ecd5)
Co-authored-by: Niels Rogge <nielsr@users.noreply.huggingface.co>
README.md
CHANGED
|
@@ -1,21 +1,29 @@
|
|
| 1 |
---
|
| 2 |
base_model: black-forest-labs/FLUX.1-dev
|
| 3 |
library_name: peft
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
---
|
| 5 |
-
# Model Card for Model ID
|
| 6 |
|
| 7 |
-
|
| 8 |
-
This model is trained using Flow-GRPO with LoRA. We provide only the LoRA weights here, so you will need to download the Flux.1-dev base model first.
|
| 9 |
|
| 10 |
-
|
| 11 |
|
| 12 |
-
|
| 13 |
|
| 14 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 15 |
|
| 16 |
-
- **Repository:** https://github.com/CIawevy/TextPecker/tree/main
|
| 17 |
-
- **Paper:** https://www.arxiv.org/pdf/2602.20903
|
| 18 |
-
## Uses
|
| 19 |
```python
|
| 20 |
import os
|
| 21 |
import torch
|
|
@@ -86,4 +94,17 @@ image = pipe(
|
|
| 86 |
# Save result (FLUX naming convention)
|
| 87 |
image.save("TextPecker_flux_demo.png")
|
| 88 |
print("Image saved as: TextPecker_flux_demo.png")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 89 |
```
|
|
|
|
| 1 |
---
|
| 2 |
base_model: black-forest-labs/FLUX.1-dev
|
| 3 |
library_name: peft
|
| 4 |
+
pipeline_tag: text-to-image
|
| 5 |
+
license: apache-2.0
|
| 6 |
+
tags:
|
| 7 |
+
- flux
|
| 8 |
+
- lora
|
| 9 |
+
- diffusers
|
| 10 |
+
- text-rendering
|
| 11 |
+
- visual-text-rendering
|
| 12 |
---
|
|
|
|
| 13 |
|
| 14 |
+
# TextPecker: Flux.1-dev-TextPecker-SQPA
|
|
|
|
| 15 |
|
| 16 |
+
This model is a LoRA adapter for [FLUX.1-dev](https://huggingface.co/black-forest-labs/FLUX.1-dev) optimized using the **TextPecker** strategy, as presented in the paper [TextPecker: Rewarding Structural Anomaly Quantification for Enhancing Visual Text Rendering](https://huggingface.co/papers/2602.20903).
|
| 17 |
|
| 18 |
+
TextPecker is a plug-and-play structural anomaly perceptive RL strategy that improves the structural fidelity and semantic alignment of visual text rendering in text-to-image generators. This repository provides the LoRA weights trained using Flow-GRPO.
|
| 19 |
|
| 20 |
+
- **Repository:** https://github.com/CIawevy/TextPecker
|
| 21 |
+
- **Paper:** [https://arxiv.org/abs/2602.20903](https://arxiv.org/abs/2602.20903)
|
| 22 |
+
|
| 23 |
+
## Usage
|
| 24 |
+
|
| 25 |
+
This model provides only the LoRA weights. You will need to load the Flux.1-dev base model first.
|
| 26 |
|
|
|
|
|
|
|
|
|
|
| 27 |
```python
|
| 28 |
import os
|
| 29 |
import torch
|
|
|
|
| 94 |
# Save result (FLUX naming convention)
|
| 95 |
image.save("TextPecker_flux_demo.png")
|
| 96 |
print("Image saved as: TextPecker_flux_demo.png")
|
| 97 |
+
```
|
| 98 |
+
|
| 99 |
+
## Citation
|
| 100 |
+
|
| 101 |
+
If you find TextPecker useful in your research or work, please cite the original paper:
|
| 102 |
+
|
| 103 |
+
```bibtex
|
| 104 |
+
@article{zhu2026TextPecker,
|
| 105 |
+
title = {TextPecker: Rewarding Structural Anomaly Quantification for Enhancing Visual Text Rendering},
|
| 106 |
+
author = {Zhu, Hanshen and Liu, Yuliang and Wu, Xuecheng and Wang, An-Lan and Feng, Hao and Yang, Dingkang and Feng, Chao and Huang, Can and Tang, Jingqun and Bai, Xiang},
|
| 107 |
+
journal = {arXiv preprint arXiv:2602.20903},
|
| 108 |
+
year = {2026}
|
| 109 |
+
}
|
| 110 |
```
|