JSONify-Flux-Large / README.md
prithivMLmods's picture
Update README.md
7117b01 verified
---
license: apache-2.0
language:
- en
- zh
base_model:
- Qwen/Qwen2-VL-7B-Instruct
pipeline_tag: image-text-to-text
library_name: transformers
tags:
- caption
- text-generation-inference
- flux
---
![9.png](https://cdn-uploads.huggingface.co/production/uploads/65bb837dbfb878f46c77de4c/esgwb8sdL5LbyDuQFLWnT.png)
# **JSONify-Flux-Large**
The **JSONify-Flux-Large** model is a fine-tuned version of **Qwen2VL**, specifically trained on **Flux-generated images** and their **corresponding captions**. This model has been trained using a **30M trainable parameter** dataset and is designed to output responses in structured **JSON format** while maintaining state-of-the-art performance in **Optical Character Recognition (OCR)**, **image-to-text conversion**, and **math problem-solving with LaTeX formatting**.
### Key Enhancements:
* **Optimized for Flux-Generated Image Captioning**: JSONify-Flux-Large has been trained to understand and describe images created using Flux-based generation techniques.
* **State-of-the-Art Image Understanding**: Built on Qwen2VL's architecture, JSONify-Flux-Large excels in visual reasoning tasks like DocVQA, RealWorldQA, MTVQA, and more.
* **Formatted JSON Output**: Responses are structured in a JSON format, making it ideal for automation, database storage, and further processing.
* **Multilingual Support**: Recognizes and extracts text from images in multiple languages, including English, Chinese, Japanese, Arabic, and various European languages.
* **Supports Multi-Turn Interactions**: Maintains context in conversations and can provide extended reasoning over multiple inputs.
### How to Use
```python
from transformers import Qwen2VLForConditionalGeneration, AutoTokenizer, AutoProcessor
from qwen_vl_utils import process_vision_info
# Load the model on the available device(s)
model = Qwen2VLForConditionalGeneration.from_pretrained(
"prithivMLmods/JSONify-Flux-Large", torch_dtype="auto", device_map="auto"
)
# Enable flash_attention_2 for better acceleration and memory efficiency
# model = Qwen2VLForConditionalGeneration.from_pretrained(
# "prithivMLmods/JSONify-Flux-Large",
# torch_dtype=torch.bfloat16,
# attn_implementation="flash_attention_2",
# device_map="auto",
# )
# Default processor
processor = AutoProcessor.from_pretrained("prithivMLmods/JSONify-Flux-Large")
messages = [
{
"role": "user",
"content": [
{
"type": "image",
"image": "https://qianwen-res.oss-cn-beijing.aliyuncs.com/Qwen-VL/assets/demo.jpeg",
},
{"type": "text", "text": "Describe this image in JSON format."},
],
}
]
# Prepare inputs for inference
text = processor.apply_chat_template(
messages, tokenize=False, add_generation_prompt=True
)
image_inputs, video_inputs = process_vision_info(messages)
inputs = processor(
text=[text],
images=image_inputs,
videos=video_inputs,
padding=True,
return_tensors="pt",
)
inputs = inputs.to("cuda")
# Inference: Generate JSON-formatted output
generated_ids = model.generate(**inputs, max_new_tokens=128)
generated_ids_trimmed = [
out_ids[len(in_ids) :] for in_ids, out_ids in zip(inputs.input_ids, generated_ids)
]
output_text = processor.batch_decode(
generated_ids_trimmed, skip_special_tokens=True, clean_up_tokenization_spaces=False
)
print(output_text) # JSON-formatted response
```
### JSON Buffer Handling
```python
buffer = ""
for new_text in streamer:
buffer += new_text
buffer = buffer.replace("<|im_end|>", "")
yield buffer
```
### **Key Features**
1. **Flux-Based Vision-Language Model**:
- Specifically trained on **Flux-generated images and captions** for precise image-to-text conversion.
2. **Optical Character Recognition (OCR)**:
- Extracts and processes text from images with high accuracy.
3. **Math and LaTeX Support**:
- Solves math problems and outputs equations in **LaTeX format**.
4. **Structured JSON Output**:
- Ensures outputs are formatted in JSON, making it suitable for API responses and automation tasks.
5. **Multi-Image and Video Understanding**:
- Supports analyzing multiple images and video content up to **20 minutes long**.
6. **Secure Weight Format**:
- Uses **Safetensors** for enhanced security and faster model loading.