Metadata-Version: 2.4
Name: edith-ai
Version: 1.0.0
Summary: EDITH — AI chat overlay with OCR screen capture, powered by OpenRouter
License: MIT
Project-URL: Homepage, https://github.com/yourname/edith-ai
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28
Requires-Dist: pynput>=1.7
Requires-Dist: easyocr>=1.7
Requires-Dist: numpy>=1.23
Requires-Dist: Pillow>=9.0
Dynamic: license-file

# EDITH — AI Chat Overlay with OCR

> **E**verything **D**one **I**n **T**he **H**eadset — a lightweight, always-on-top AI chat overlay with screen-capture OCR.

## Install

```bash
pip install edith-ai
```

## Usage

```bash
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](https://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](https://openrouter.ai) API key

## License

MIT
