kortalk 0.4.0__tar.gz

kortalk-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kortalk contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kortalk-0.4.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: kortalk
+Version: 0.4.0
+Summary: Korvus AI popup: выделенный текст → Claude, OpenAI, локальные модели. Трей, стриминг, два языка.
+Author: kortalk contributors
+License: MIT
+Project-URL: Homepage, https://github.com/r4ven-me/kortalk
+Keywords: korvus,claude,openai,ollama,clipboard,popup,qt,tray
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Desktop Environment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6>=6.5
+Requires-Dist: anthropic>=0.40
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: pytest-qt>=4; extra == "test"
+Dynamic: license-file
+
+# kortalk
+
+**Korvus AI popup** — приложение семейства **korvus** (korserver, korctl, kortalk).
+AI-popup для выделенного текста в духе [Crow Translate](https://crow-translate.github.io/):
+выделили текст мышью → нажали хоткей → у курсора всплыло окошко с ответом ИИ.
+Живёт в трее, стримит ответы, поддерживает несколько провайдеров.
+
+## Возможности
+
+- **Popup у курсора** — скруглённые углы, Markdown-рендер ответа с подсветкой
+  блоков кода, стриминг токенов в реальном времени, выделение/копирование
+  текста. Закрывается по клику за пределами окна или `Escape`.
+- **Окно в два столбца** — редактируемый промпт+текст слева, ответ справа,
+  выбор провайдера на панели, `Ctrl+Enter` для отправки.
+- **Трей** — приложение резидентно: монохромный ворон (Corvus — символ korvus), ЛКМ = popup
+  с выделением, меню с библиотекой промптов, окном, настройками и выходом.
+- **Глобальные хоткеи внутри приложения** — назначаются в настройках
+  (по умолчанию `Ctrl+Alt+C` popup, `Ctrl+Alt+W` окно). X11 — прямой
+  перехват XGrabKey, Wayland — системный портал GlobalShortcuts.
+  Никаких внешних утилит и настройки DE не требуется.
+- **Библиотека промптов** — несколько именованных промптов в настройках;
+  промпт по умолчанию для хоткея, любой другой — из подменю трея.
+- **Провайдеры ИИ**:
+  - **Claude Code CLI** — через `claude -p`, без API-ключа (по умолчанию);
+  - **Anthropic API** — официальный SDK, стриминг (нужен API-ключ);
+  - **OpenAI-совместимые API** — OpenAI, **Ollama**, LM Studio, OpenRouter,
+    Groq, DeepSeek и любой другой сервис с `/chat/completions` (настраивается
+    `base URL` + модель + ключ, для локальных серверов ключ не нужен).
+- **Графические настройки** — промпты, клавиши, тема, шрифт, размеры popup,
+  таймауты, менеджер провайдеров с ключами, автозапуск при входе.
+  Конфиг — человекочитаемый YAML (`~/.config/kortalk/config.yaml`).
+- **Тема и шрифты** — по умолчанию следует теме окружения (Qt), опционально
+  Nord Dark / Nord Light.
+- **Два языка интерфейса** — английский (по умолчанию) и русский:
+  Настройки → Общие → Language.
+- **PRIMARY-выделение читается нативно** через Qt — xclip/xsel/wl-clipboard
+  больше не нужны. Работает на X11 и Wayland.
+
+## Установка
+
+```bash
+pipx install kortalk
+kortalk --check     # диагностика: провайдеры, трей, PRIMARY-выделение
+```
+
+Никаких системных пакетов и флагов вроде `--system-site-packages` не
+требуется — Qt (PySide6) ставится из PyPI. Единственная внешняя зависимость —
+[Claude Code CLI](https://docs.claude.com), и только если используете
+провайдер `claude-cli`.
+
+> Конфиг хранится в `~/.config/kortalk/config.yaml` и редактируется через
+> настройки (или руками). Конфиги прежних версий (toml/ini) не используются.
+
+## Использование
+
+```bash
+kortalk                       # запустить демона (трей + хоткеи)
+kortalk --popup               # popup у курсора (для скриптов/сторонних хоткеев)
+kortalk "Переведи на английский:"   # popup с разовым промптом
+kortalk --window              # окно в два столбца (алиас: --split)
+kortalk --provider ollama     # разовый запрос через конкретный провайдер
+kortalk --settings            # настройки
+kortalk --quit                # завершить работающий экземпляр
+kortalk --check               # диагностика
+```
+
+Основной сценарий: `kortalk` запускает демона, дальше всё делается из трея
+и по глобальным хоткеям. CLI-флаги оставлены для скриптов — они мгновенно
+доставляются работающему экземпляру через локальный сокет.
+
+Текст берётся из **PRIMARY selection** — достаточно выделить его мышью,
+Ctrl+C не нужен.
+
+## Хоткеи
+
+Назначаются в Настройки → Клавиши, работают глобально:
+
+- **X11** — приложение перехватывает клавиши напрямую (XGrabKey),
+  работает в любом WM/DE без настройки.
+- **Wayland** — используется XDG Desktop Portal (GlobalShortcuts);
+  GNOME/KDE покажут диалог подтверждения биндинга. Если портал недоступен
+  (минималистичные композиторы) — пользуйтесь треем или повесьте
+  `kortalk --popup` на хоткей средствами композитора.
+
+## Настройка провайдеров
+
+`kortalk --settings` → вкладка «Провайдеры». Примеры:
+
+| Провайдер | Тип | Base URL | Модель |
+|---|---|---|---|
+| Claude Code CLI | claude-cli | — | *(пусто = дефолт CLI)* |
+| Anthropic API | anthropic | — | `claude-opus-4-8` |
+| OpenAI | openai | `https://api.openai.com/v1` | `gpt-4o` |
+| Ollama | openai | `http://localhost:11434/v1` | `llama3`, `qwen3`, … |
+| LM Studio | openai | `http://localhost:1234/v1` | имя загруженной модели |
+| OpenRouter | openai | `https://openrouter.ai/api/v1` | любой из каталога |
+
+«Активный провайдер» используется по умолчанию для popup; в окне провайдер
+выбирается в выпадающем списке, разово — флагом `--provider <id>`.
+
+## Автозапуск
+
+Настройки → Общие → «Запускать при входе в систему» — создаёт
+`~/.config/autostart/kortalk.desktop` с командой `kortalk`.
+
+## Разработка
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install -e .
+QT_QPA_PLATFORM=offscreen .venv/bin/kortalk --check   # headless-проверка
+```
+
+Структура: [src/kortalk/](src/kortalk/) — `app.py` (CLI, трей, IPC),
+`providers.py` (воркеры ИИ), `hotkeys.py` (XGrabKey / портал),
+`windows.py` (popup и главное окно), `settings_dialog.py`, `config.py`,
+`theme.py`.
+
+## Лицензия
+
+MIT, см. [LICENSE](LICENSE).
+
+## Разработка
+
+```bash
+git clone https://github.com/r4ven-me/kortalk && cd kortalk
+python -m venv .venv && . .venv/bin/activate
+pip install -e '.[test]' ruff
+ruff check .                        # линтер
+QT_QPA_PLATFORM=offscreen pytest    # тесты (headless)
+```
+
+Логи работающего приложения: `~/.local/state/kortalk/kortalk.log`
+(подробный вывод — флаг `--debug`).

kortalk-0.4.0/README.md

@@ -0,0 +1,133 @@
+# kortalk
+
+**Korvus AI popup** — приложение семейства **korvus** (korserver, korctl, kortalk).
+AI-popup для выделенного текста в духе [Crow Translate](https://crow-translate.github.io/):
+выделили текст мышью → нажали хоткей → у курсора всплыло окошко с ответом ИИ.
+Живёт в трее, стримит ответы, поддерживает несколько провайдеров.
+
+## Возможности
+
+- **Popup у курсора** — скруглённые углы, Markdown-рендер ответа с подсветкой
+  блоков кода, стриминг токенов в реальном времени, выделение/копирование
+  текста. Закрывается по клику за пределами окна или `Escape`.
+- **Окно в два столбца** — редактируемый промпт+текст слева, ответ справа,
+  выбор провайдера на панели, `Ctrl+Enter` для отправки.
+- **Трей** — приложение резидентно: монохромный ворон (Corvus — символ korvus), ЛКМ = popup
+  с выделением, меню с библиотекой промптов, окном, настройками и выходом.
+- **Глобальные хоткеи внутри приложения** — назначаются в настройках
+  (по умолчанию `Ctrl+Alt+C` popup, `Ctrl+Alt+W` окно). X11 — прямой
+  перехват XGrabKey, Wayland — системный портал GlobalShortcuts.
+  Никаких внешних утилит и настройки DE не требуется.
+- **Библиотека промптов** — несколько именованных промптов в настройках;
+  промпт по умолчанию для хоткея, любой другой — из подменю трея.
+- **Провайдеры ИИ**:
+  - **Claude Code CLI** — через `claude -p`, без API-ключа (по умолчанию);
+  - **Anthropic API** — официальный SDK, стриминг (нужен API-ключ);
+  - **OpenAI-совместимые API** — OpenAI, **Ollama**, LM Studio, OpenRouter,
+    Groq, DeepSeek и любой другой сервис с `/chat/completions` (настраивается
+    `base URL` + модель + ключ, для локальных серверов ключ не нужен).
+- **Графические настройки** — промпты, клавиши, тема, шрифт, размеры popup,
+  таймауты, менеджер провайдеров с ключами, автозапуск при входе.
+  Конфиг — человекочитаемый YAML (`~/.config/kortalk/config.yaml`).
+- **Тема и шрифты** — по умолчанию следует теме окружения (Qt), опционально
+  Nord Dark / Nord Light.
+- **Два языка интерфейса** — английский (по умолчанию) и русский:
+  Настройки → Общие → Language.
+- **PRIMARY-выделение читается нативно** через Qt — xclip/xsel/wl-clipboard
+  больше не нужны. Работает на X11 и Wayland.
+
+## Установка
+
+```bash
+pipx install kortalk
+kortalk --check     # диагностика: провайдеры, трей, PRIMARY-выделение
+```
+
+Никаких системных пакетов и флагов вроде `--system-site-packages` не
+требуется — Qt (PySide6) ставится из PyPI. Единственная внешняя зависимость —
+[Claude Code CLI](https://docs.claude.com), и только если используете
+провайдер `claude-cli`.
+
+> Конфиг хранится в `~/.config/kortalk/config.yaml` и редактируется через
+> настройки (или руками). Конфиги прежних версий (toml/ini) не используются.
+
+## Использование
+
+```bash
+kortalk                       # запустить демона (трей + хоткеи)
+kortalk --popup               # popup у курсора (для скриптов/сторонних хоткеев)
+kortalk "Переведи на английский:"   # popup с разовым промптом
+kortalk --window              # окно в два столбца (алиас: --split)
+kortalk --provider ollama     # разовый запрос через конкретный провайдер
+kortalk --settings            # настройки
+kortalk --quit                # завершить работающий экземпляр
+kortalk --check               # диагностика
+```
+
+Основной сценарий: `kortalk` запускает демона, дальше всё делается из трея
+и по глобальным хоткеям. CLI-флаги оставлены для скриптов — они мгновенно
+доставляются работающему экземпляру через локальный сокет.
+
+Текст берётся из **PRIMARY selection** — достаточно выделить его мышью,
+Ctrl+C не нужен.
+
+## Хоткеи
+
+Назначаются в Настройки → Клавиши, работают глобально:
+
+- **X11** — приложение перехватывает клавиши напрямую (XGrabKey),
+  работает в любом WM/DE без настройки.
+- **Wayland** — используется XDG Desktop Portal (GlobalShortcuts);
+  GNOME/KDE покажут диалог подтверждения биндинга. Если портал недоступен
+  (минималистичные композиторы) — пользуйтесь треем или повесьте
+  `kortalk --popup` на хоткей средствами композитора.
+
+## Настройка провайдеров
+
+`kortalk --settings` → вкладка «Провайдеры». Примеры:
+
+| Провайдер | Тип | Base URL | Модель |
+|---|---|---|---|
+| Claude Code CLI | claude-cli | — | *(пусто = дефолт CLI)* |
+| Anthropic API | anthropic | — | `claude-opus-4-8` |
+| OpenAI | openai | `https://api.openai.com/v1` | `gpt-4o` |
+| Ollama | openai | `http://localhost:11434/v1` | `llama3`, `qwen3`, … |
+| LM Studio | openai | `http://localhost:1234/v1` | имя загруженной модели |
+| OpenRouter | openai | `https://openrouter.ai/api/v1` | любой из каталога |
+
+«Активный провайдер» используется по умолчанию для popup; в окне провайдер
+выбирается в выпадающем списке, разово — флагом `--provider <id>`.
+
+## Автозапуск
+
+Настройки → Общие → «Запускать при входе в систему» — создаёт
+`~/.config/autostart/kortalk.desktop` с командой `kortalk`.
+
+## Разработка
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install -e .
+QT_QPA_PLATFORM=offscreen .venv/bin/kortalk --check   # headless-проверка
+```
+
+Структура: [src/kortalk/](src/kortalk/) — `app.py` (CLI, трей, IPC),
+`providers.py` (воркеры ИИ), `hotkeys.py` (XGrabKey / портал),
+`windows.py` (popup и главное окно), `settings_dialog.py`, `config.py`,
+`theme.py`.
+
+## Лицензия
+
+MIT, см. [LICENSE](LICENSE).
+
+## Разработка
+
+```bash
+git clone https://github.com/r4ven-me/kortalk && cd kortalk
+python -m venv .venv && . .venv/bin/activate
+pip install -e '.[test]' ruff
+ruff check .                        # линтер
+QT_QPA_PLATFORM=offscreen pytest    # тесты (headless)
+```
+
+Логи работающего приложения: `~/.local/state/kortalk/kortalk.log`
+(подробный вывод — флаг `--debug`).

kortalk-0.4.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kortalk"
+version = "0.4.0"
+description = "Korvus AI popup: выделенный текст → Claude, OpenAI, локальные модели. Трей, стриминг, два языка."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [{ name = "kortalk contributors" }]
+keywords = ["korvus", "claude", "openai", "ollama", "clipboard", "popup", "qt", "tray"]
+classifiers = [
+    "Environment :: X11 Applications :: Qt",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: Desktop Environment",
+]
+dependencies = [
+    "PySide6>=6.5",
+    "anthropic>=0.40",
+    "PyYAML>=6.0",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=7", "pytest-qt>=4"]
+
+[project.urls]
+Homepage = "https://github.com/r4ven-me/kortalk"
+
+[project.scripts]
+kortalk = "kortalk.app:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP"]

kortalk-0.4.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kortalk-0.4.0/src/kortalk/__init__.py

@@ -0,0 +1,7 @@
+"""kortalk — отправка выделенного текста в ИИ (Claude, OpenAI, локальные модели).
+
+GUI на PySide6: popup у курсора, окно в два столбца, иконка в трее,
+графические настройки. Вдохновлено Crow Translate.
+"""
+
+__version__ = "0.4.0"

kortalk-0.4.0/src/kortalk/__main__.py

@@ -0,0 +1,4 @@
+from .app import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())