← all repositories
ishan0102/vimGPT

Teaching GPT-4V to Browse Like a Keyboard Nerd

It tests whether GPT-4V can browse the web using only screenshots and Vimium keyboard overlays, skipping the DOM entirely.

2.7k stars Python AgentsLanguage Models
vimGPT
Not currently ranked — collecting fresh signals.
star history

What it does vimGPT feeds GPT-4V a live screenshot stream from a Playwright browser running the Vimium extension. The model issues keyboard commands—triggering Vimium’s link hints and shortcuts—to navigate, click, and scroll without receiving any raw HTML or DOM text. You can also state an objective aloud in voice mode and watch the agent attempt to carry it out in real time.

The interesting bit The project treats Vimium’s yellow keyboard labels as a visual API for the page. Since GPT-4V can read on-screen letters but struggles with precise pixel coordinates, the model simply “presses” the key shown over a link to interact with it. It is a low-tech, clever workaround for the lack of native vision function calling.

Key highlights

  • Purely vision-driven: the model sees the page through screenshots, not markup.
  • Uses Vimium overlays as spatial shortcuts, avoiding coordinate-guessing.
  • Voice mode allows hands-free objective setting.
  • Runs a local Playwright browser with a manually loaded Vimium extension.
  • Referenced in VisualWebArena research and WIRED coverage.

Caveats

  • The Vision API lacks JSON mode and function calling, forcing “more primitive prompting methods.”
  • Low-resolution screenshots cause the model to miss elements entirely.
  • It currently spins up an artificial browser; it cannot yet control your personal profile or saved passwords.

Verdict A neat sandbox for anyone building multimodal web agents or probing the limits of vision-only interaction. If you need a stable daily driver for actual browsing tasks, this is still firmly in the experiment column.

Frequently asked

What is ishan0102/vimGPT?
It tests whether GPT-4V can browse the web using only screenshots and Vimium keyboard overlays, skipping the DOM entirely.
Is vimGPT open source?
Yes — ishan0102/vimGPT is open source, released under the MIT license.
What language is vimGPT written in?
ishan0102/vimGPT is primarily written in Python.
How popular is vimGPT?
ishan0102/vimGPT has 2.7k stars on GitHub.
Where can I find vimGPT?
ishan0102/vimGPT is on GitHub at https://github.com/ishan0102/vimGPT.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.