Instructions to use deepseek-ai/DeepSeek-OCR with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use deepseek-ai/DeepSeek-OCR with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="deepseek-ai/DeepSeek-OCR", trust_remote_code=True)# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("deepseek-ai/DeepSeek-OCR", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use deepseek-ai/DeepSeek-OCR with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "deepseek-ai/DeepSeek-OCR" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "deepseek-ai/DeepSeek-OCR", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/deepseek-ai/DeepSeek-OCR
- SGLang
How to use deepseek-ai/DeepSeek-OCR 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 "deepseek-ai/DeepSeek-OCR" \ --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": "deepseek-ai/DeepSeek-OCR", "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 "deepseek-ai/DeepSeek-OCR" \ --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": "deepseek-ai/DeepSeek-OCR", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use deepseek-ai/DeepSeek-OCR with Docker Model Runner:
docker model run hf.co/deepseek-ai/DeepSeek-OCR
add GGUF model for ollama inference
.
Pretty plz
This would be very helpful. I hope someone is working on it.
+1
使用 llama-cpp 可以自己转换吧
GGUF Available in NexaSDK (only). Here's how to run it locally:
Model Card: https://huggingface.co/NexaAI/DeepSeek-OCR-GGUF
Quickstart
Install NexaSDK
Run the model locally with one line of code:
nexa infer NexaAI/DeepSeek-OCR-GGUFThen drag your image to terminal or type into the image path
case 1 : extract text
<your-image-path> Free OCR.
case 2 : extract bounding box
<your-image-path> <|grounding|>Convert the document to markdown.
Note: If the model fails to run, install the latest Vulkan driver for Windows
There is a model that runs directly in ollama now.
You will need the latest docker image:
ollama/ollama:0.13.0-rc0 (0.12.11 will not work)
you use the following image:
ollama run mike/deepseek-ocr
Enjoy
hey @jcuypers , unlike from their official page, how we can use the model parameters in the inference call? for example
model.infer(
tokenizer,
prompt=prompt,
image_file=image_path,
output_path=output_dir,
base_size=xxxx,
image_size=xxxx,
crop_mode=xxxxx,
save_results=xxxx,
test_compress=xxxx
)
hi @gsvc , haven't tried it yet, but i guess it would have to be through the kwargs arguments used in some other tools (like langchain -> langchain_ollama / langchain_openai). similar as temperature etc is set through these frameworks. maybe someone else has tried this and can comment. thanks.
@gsvc , it is possible to use others. I personally used "num_ctx" and it loaded the model with the provided context size. Also openwebui allows for customization directly to ollama, so there is a possibility. not sure whether it was through ollama or openai interface, but it is available. this doesn't solve your problem since the list of parameters is fixed.
I think what you are looking for is here:
https://reference.langchain.com/python/integrations/langchain_openai/ChatOpenAI/#langchain_openai.chat_models.ChatOpenAI
model_kwargs / extra_body section
gl,j.