whatisgithub

What is cogvlm?

zai-org/cogvlm — explained in plain English

Analysis updated 2026-06-24

6,743PythonAudience · researcherComplexity · 4/5Setup · hard

In one sentence

Open-source AI models that can look at images, answer questions about them, read text in screenshots, and automate graphical interfaces, all running locally on your own GPU hardware.

Mindmap

mindmap
  root((CogVLM))
    What it does
      Image understanding
      Visual Q and A
      GUI automation
    Models
      CogVLM-17B base
      CogAgent high-res
      CogVLM2 follow-up
    Requirements
      Nvidia GPU required
      11GB min with 4-bit
      Hugging Face download
    Capabilities
      Read text in images
      Control interfaces
      Image conversation
Click or tap to explore — scroll the page freely

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

Run a local AI that answers natural language questions about any image without sending data to a cloud API.

USE CASE 2

Automate graphical interface tasks by feeding CogAgent screenshots of a computer screen and asking it what to click or type.

USE CASE 3

Extract and read text from screenshots, scanned documents, or image files using CogAgent's high-resolution vision capability.

USE CASE 4

Fine-tune CogVLM on your own image-text dataset to specialize it for a specific visual question-answering task.

What is it built with?

PythonPyTorchHugging Face TransformersCUDA

How does it compare?

zai-org/cogvlmpyeve/evepython-eel/eel
Stars6,7436,7386,750
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity4/53/52/5
Audienceresearcherdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires one or more Nvidia GPUs, minimum ~11GB VRAM in 4-bit compressed mode, no CPU fallback available.

Code portions are open-source, model weights carry a separate model license, check the Hugging Face model page for full terms.

So what is it?

CogVLM and CogAgent are open-source AI models that can look at an image and answer questions about it, carry on a back-and-forth conversation about what they see, and identify specific regions of an image when asked. The repository contains code for running these models yourself and documentation for fine-tuning them on your own data. CogVLM-17B is the base visual language model. It has two sets of parameters: one for understanding images and one for language, totaling 17 billion parameters. It can handle images at 490 by 490 pixel resolution and was evaluated across a range of standard vision-and-language tests, placing at or near the top on ten of them at the time of its release. CogAgent is built on top of CogVLM and adds support for a higher image resolution (1120 by 1120 pixels), which makes it better at reading text in images like screenshots and documents. It also adds a specific capability for controlling graphical interfaces: given a screenshot of a computer screen, it can describe what to click or type to complete a task. This is sometimes called a GUI agent. It was evaluated on nine cross-modal benchmarks and on datasets specifically for computer interface automation. To run the models locally, you need a machine with one or more Nvidia GPUs. The README documents the minimum GPU memory required for different configurations, including a 4-bit compressed mode that can run with roughly 11 GB of GPU memory. Models can be loaded from Hugging Face with a few lines of Python code, or run through a provided command-line tool or a local web interface. A newer follow-up model called CogVLM2, based on a different underlying language model, was released in May 2024 and is linked from the README as a recommended upgrade for new projects.

Copy-paste prompts

Prompt 1
I have CogVLM loaded from Hugging Face. Write me the Python code to load an image from disk and ask it what objects are in the image, then print the answer.
Prompt 2
I want to use CogAgent to automate a task on my desktop. Show me how to pass it a screenshot and parse its output to find out which element it says to click.
Prompt 3
I have 11GB of GPU memory. Show me the Python code to load CogVLM-17B in 4-bit quantized mode as documented in the CogVLM repository.
Prompt 4
Help me set up a fine-tuning run on CogVLM for a custom image-text task, what data format does the repository expect and which training script should I use?

Frequently asked questions

What is cogvlm?

Open-source AI models that can look at images, answer questions about them, read text in screenshots, and automate graphical interfaces, all running locally on your own GPU hardware.

What language is cogvlm written in?

Mainly Python. The stack also includes Python, PyTorch, Hugging Face Transformers.

What license does cogvlm use?

Code portions are open-source, model weights carry a separate model license, check the Hugging Face model page for full terms.

How hard is cogvlm to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is cogvlm for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.