whatisgithub

What is deepseek-vision?

erlichliu/deepseek-vision — explained in plain English

Analysis updated 2026-05-18

46PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A proxy server that adds image understanding, web search, and web page fetching to DeepSeek's text-only AI models.

Mindmap

mindmap
  root((deepseek-vision))
    What it does
      Adds vision support
      Adds web search
      Adds web fetch
    Tech stack
      Python
      Docker
      FastAPI
    Use cases
      Vision for DeepSeek
      Web search in agents
      Unified API key
    Audience
      Developers
      Agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give a text-only DeepSeek model the ability to understand images sent in a chat request.

USE CASE 2

Let an AI coding tool like Claude Code use DeepSeek while still supporting web search and page fetching.

USE CASE 3

Connect both Anthropic-style and OpenAI-style client tools to the same DeepSeek backend with one API key.

What is it built with?

PythonDockerFastAPI

How does it compare?

erlichliu/deepseek-visionbetta-tech/harness-sddemmimal/control-layer
Stars464646
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a DeepSeek API key plus optional vision/search provider keys, and Docker or a local Python environment.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

So what is it?

DeepSeek is an AI model provider whose official API only processes text. That means if you want to send an image to a DeepSeek model, or have it search the web, it cannot do those things on its own. This project is a proxy service that sits between your AI tools and the DeepSeek API, quietly adding the missing capabilities so your tools think they are talking to a fully featured model. The proxy adds three things. First, it adds vision support: when a request includes an image, the proxy sends that image to a separate vision model (by default Alibaba Cloud's Qwen vision model), converts it into a text description, and replaces the image block with that description before forwarding to DeepSeek. Second, it adds web search: when a tool in your conversation calls for a web search, the proxy intercepts it, queries Tavily or Brave, and injects the results back into the context. Third, it adds web fetch, which lets the model read content from a URL, with built-in protections against certain types of server-side abuse. The proxy also speaks two different API dialects. Tools built for Anthropic's API format and tools built for OpenAI's API format can both connect to the same proxy. The proxy translates between those formats and routes everything through to DeepSeek, so you can use a single DeepSeek API key with a wide range of AI tools without changing how those tools are configured. Setting it up requires Docker or a local Python environment. You provide a few environment variables: a master API key that clients use to authenticate with the proxy, your DeepSeek API key, and optionally keys for the vision and search providers. A built-in web interface at the service's root URL lets you update configuration and restart the service without editing files directly. The project is released under the MIT license and notes that it is a companion open-source project to a hosted agent service called Proma.

Copy-paste prompts

Prompt 1
Walk me through deploying this deepseek-vision proxy with Docker and setting the required environment variables.
Prompt 2
Explain how the vision middleware in this repo converts an image block into a text description before sending it to DeepSeek.
Prompt 3
Show me how to configure this proxy to use Brave instead of Tavily for web search.
Prompt 4
Help me add a second Anthropic-compatible backend alongside DeepSeek using the EXTRA_BACKEND environment variables.

Frequently asked questions

What is deepseek-vision?

A proxy server that adds image understanding, web search, and web page fetching to DeepSeek's text-only AI models.

What language is deepseek-vision written in?

Mainly Python. The stack also includes Python, Docker, FastAPI.

What license does deepseek-vision use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is deepseek-vision to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is deepseek-vision for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.