explaingit

zebinlu7-a11y/screen-flow-ai-agent

Analysis updated 2026-05-18

38PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A floating desktop chat panel that lets you screenshot any part of your screen and get streaming AI answers or extracted text back instantly.

Mindmap

mindmap
  root((screen-flow-ai-agent))
    What it does
      Floating chat window
      Screenshot questions
      OCR text extraction
    Tech stack
      Python
      LangGraph
      DouBao model
    Use cases
      Ask AI about a screenshot
      Extract text with OCR
      Switch model tiers
    Audience
      Desktop AI users

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

Select any region of your screen and ask an AI to explain code, a chart, or a UI design shown there.

USE CASE 2

Extract readable text from a screenshot using the built in OCR shortcut instead of typing it out.

USE CASE 3

Keep a small always on top chat window available for quick questions while working in other apps.

USE CASE 4

Switch between mini, lite, and pro model tiers depending on how much reasoning a question needs.

What is it built with?

PythonLangGraphVolcEngine DouBaoTencent Cloud OCR

How does it compare?

zebinlu7-a11y/screen-flow-ai-agentadewale/skill-eval-harnessdragonmeow1012/dragonmeow-mangatranslator
Stars383838
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity2/53/53/5
Audiencegeneraldevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a VolcEngine API key for the multimodal model, the OCR feature needs separate optional Tencent Cloud credentials.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

This is a Python desktop app that keeps a small floating chat panel visible on top of all your other windows. When you run it, the panel sits in the corner of your screen and you can type questions into the bottom bar at any time, getting AI answers that stream in word by word. The main feature is screenshot-based questioning. Press Ctrl+D to draw a selection box around anything on your screen and the app captures that region as an image. You can grab multiple regions in one session, then submit them all together with a typed question. The AI reads the captured images and responds based on what it sees, whether that is code, a chart, a UI design, or any other visual content. There is also a separate OCR mode triggered with Ctrl+R. Instead of sending the screenshot to the AI, this route runs it through Tencent Cloud's text-recognition service and extracts the readable text. The result lands in the chat input so you can copy it, edit it, or ask a follow-up question about it. The Tencent OCR service comes with a free allowance of 1,000 calls per month. The floating window itself is adjustable: resize it, drag it anywhere on screen, make it semi-transparent, or hide it entirely with Ctrl+F. A system tray icon keeps the app accessible without cluttering your taskbar. Three model tiers (mini, lite, pro) can be switched at any time from inside the window. API keys and proxy settings are entered through a settings button in the UI, so no manual config file editing is needed. Under the hood the project uses Python with LangGraph managing the conversation flow. The AI backend is the DouBao multimodal model from ByteDance's VolcEngine platform, which handles both text and images in the same request. A pre-built Windows executable is available in the releases section if you prefer not to run from source.

Copy-paste prompts

Prompt 1
Help me install screen-flow-ai-agent and configure my VolcEngine API key so it runs on my machine.
Prompt 2
Explain how the Ctrl+D screenshot capture and Ctrl+R OCR shortcuts differ in this app.
Prompt 3
Show me how to switch between the mini, lite, and pro model tiers in this floating chat window.
Prompt 4
Walk me through setting up the optional Tencent Cloud OCR credentials for this project.

Frequently asked questions

What is screen-flow-ai-agent?

A floating desktop chat panel that lets you screenshot any part of your screen and get streaming AI answers or extracted text back instantly.

What language is screen-flow-ai-agent written in?

Mainly Python. The stack also includes Python, LangGraph, VolcEngine DouBao.

What license does screen-flow-ai-agent use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is screen-flow-ai-agent to set up?

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

Who is screen-flow-ai-agent for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.