Image-Text-to-Text
Transformers
Safetensors
English
llava_llama
ocr
vision-language
qwen2-vl
vila
multimodal
Instructions to use pkulium/easy_deepocr with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use pkulium/easy_deepocr with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="pkulium/easy_deepocr")# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("pkulium/easy_deepocr", dtype="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps
- vLLM
How to use pkulium/easy_deepocr with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "pkulium/easy_deepocr" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "pkulium/easy_deepocr", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/pkulium/easy_deepocr
- SGLang
How to use pkulium/easy_deepocr with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "pkulium/easy_deepocr" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "pkulium/easy_deepocr", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "pkulium/easy_deepocr" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "pkulium/easy_deepocr", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use pkulium/easy_deepocr with Docker Model Runner:
docker model run hf.co/pkulium/easy_deepocr
Easy DeepOCR - VILA-Qwen2-VL-8B
A vision-language model fine-tuned for OCR tasks, based on VILA architecture with Qwen2-VL-8B as the language backbone.
Model Description
This model combines:
- Language Model: Qwen2-VL-8B
- Vision Encoders: SAM + CLIP
- Architecture: VILA (Visual Language Adapter)
- Task: Optical Character Recognition (OCR)
Model Structure
easy_deepocr/
βββ config.json # Model configuration
βββ llm/ # Qwen2-VL-8B language model weights
βββ mm_projector/ # Multimodal projection layer
βββ sam_clip_ckpt/ # SAM and CLIP vision encoder weights
βββ trainer_state.json # Training state information
Usage
# TODO: Add your inference code here
from transformers import AutoModel, AutoTokenizer
model = AutoModel.from_pretrained("pkulium/easy_deepocr", trust_remote_code=True)
tokenizer = AutoTokenizer.from_pretrained("pkulium/easy_deepocr")
# Example inference
# image = ...
# text = ...
Training Details
- Base Model: Qwen2-VL-8B
- Vision Encoders: SAM + CLIP
- Training Framework: VILA
- Training Type: Pretraining for OCR tasks
Intended Use
This model is designed for:
- Document OCR
- Scene text recognition
- Handwriting recognition
- Multi-language text extraction
Limitations
- [Add any known limitations]
- Model performance may vary with image quality
- Best suited for [specify use cases]
Citation
If you use this model, please cite:
@misc{easy_deepocr,
author = {Ming Liu},
title = {Easy DeepOCR - VILA-Qwen2-VL-8B},
year = {2025},
publisher = {HuggingFace},
url = {https://huggingface.co/pkulium/easy_deepocr}
}
Acknowledgments
- Downloads last month
- 8
Inference Providers NEW
This model isn't deployed by any Inference Provider. π Ask for provider support