Skip to main content

EDITH — AI Chat Overlay with OCR

Everything Done In The Headset — a lightweight, always-on-top AI chat overlay with screen-capture OCR.

Install

pip install edith-ai

Usage

edith

Set your API key first

Platform Command
Windows set OPENROUTER_API_KEY=sk-or-v1-...
macOS/Linux export OPENROUTER_API_KEY=sk-or-v1-...

Get a free key at openrouter.ai.

Hotkeys

Hotkey Action
Ctrl+Alt+Space Show / hide the chat window
Ctrl+Alt+S Open screen-region selector (OCR)
Ctrl+Alt+C Paste OCR result into the input box
Escape Hide the chat window

How it works

  1. Run edith — a small chat window appears bottom-left.
  2. Press Ctrl+Alt+Space to toggle it from anywhere.
  3. Press Ctrl+Alt+S, drag a rectangle over any text on your screen.
  4. Press Ctrl+Alt+C to paste the recognised text into the prompt.
  5. Hit Enter or Send — EDITH replies using deepseek/deepseek-chat via OpenRouter.

Requirements

  • Python 3.8+
  • tkinter (bundled with most Python installs; on Ubuntu: sudo apt install python3-tk)
  • A free OpenRouter API key

License

MIT

Metadata

Release files for edith-ai 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for edith-ai 1.0.0
File Size Uploaded Provenance Actions
edith_ai-1.0.0.tar.gz 7.0 kB Without provenance Details for edith_ai-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for edith-ai 1.0.0
File Interpreter ABI Platform Actions
edith_ai-1.0.0-py3-none-any.whl Python 3 none any Details for edith_ai-1.0.0-py3-none-any.whl

Total release size: 14.5 kB

Release files / edith_ai-1.0.0.tar.gz

Download URL edith_ai-1.0.0.tar.gz
Size 7.0 kB
Tags Source
SHA-256 checksum
How to use checksums
45d30ce09618b6a6c75c227bc6a8acc900d5fb2c84448d579909251a77e2eeb7
BLAKE2b-256 checksum
How to use checksums
91ebdf530cbad2e7f0df9da3fa3343014146d18d39dfdcfa953e8eca27b18c10
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.4

Release files / edith_ai-1.0.0-py3-none-any.whl

Download URL edith_ai-1.0.0-py3-none-any.whl
Size 7.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
103a6f52708959afae3040af0a6d89fa4634054a22cecf1bb40639d26393f3b9
BLAKE2b-256 checksum
How to use checksums
355f758d486f2da435f2c9919a3dc99f442e254f40b6bbc7c1772c444e8f86ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.4

Security for edith-ai 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page