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
Browse filesHi there! I'm Niels from the Hugging Face community science team.
I've updated the model card for this repository to include relevant metadata such as the pipeline tag and license. I've also added a link to the original paper and the project's GitHub repository to improve documentation and discoverability. Specifically:
- Added `pipeline_tag: text-to-image`.
- Added `license: apache-2.0`.
- Included a link to the [research paper](https://huggingface.co/papers/2602.20903).
- Maintained the existing sample usage and citation.
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 |
```
|