Документація

CapyBro — це Windows tray-утиліта яка пускає AI у вашу повсякденну роботу з текстом без жодного зайвого кроку. Виділили текст у Word, Chrome, VS Code, Slack, Notepad — будь-де → натиснули глобальний хоткей (Ctrl+Shift+E за замовчуванням) → AI переписав за вашим промптом → новий текст уже стоїть на місці виділеного.

Ніяких вкладок браузера, copy-paste у ChatGPT і назад, ніяких ручних промптів щоразу. Працює офлайн-як-можливо: один HTTPS-запит до OpenRouter (десятки моделей через єдиний акаунт — GPT-4o, Claude, Gemini, Llama тощо), решта — локально. Native .NET 8 / WPF, без Electron. Сидить у системному треї і прокидається тільки на ваш хоткей.

Завантажити

Скачайте останній реліз з GitHub Releases — файл CapyBro-Setup-2.0.0.exe (~48 MB). Або зайдіть на capybro.app — там завжди свіже посилання.

Запустити інсталятор

Запустіть інсталятор → майстер у 3 кліки → готово. Іконка з'явиться у системному треї біля годинника. Інсталятор per-user — НЕ потребує адмін-прав, ставить у %LOCALAPPDATA%\CapyBro\.

Через winget

Маєте Windows Package Manager (winget — вбудований у Windows 11 і свіжі Windows 10)? Це найшвидший шлях: одна команда в PowerShell або Terminal завантажує і встановлює CapyBro з офіційного маніфесту.

Оновлення будь-коли — winget upgrade RomanTykhonenko.CapyBro, видалення — winget uninstall RomanTykhonenko.CapyBro.

Перший запуск запускає onboarding-візард з 4 кроків:

1. Вітання + мова інтерфейсу — короткий інтро та селектор мови (English / Українська / Русский). Перемикання тут миттєво перемальовує весь візард, щоб ви могли читати наступні кроки своєю мовою.
2. API-ключ OpenRouter — вставте ключ з openrouter.ai/keys. Візард пінгує /credits через 400 мс після останнього натиску і показує зелену галочку або помилку. Немає ключа? Пропустіть — пізніше можна перемкнутись на Ollama в Налаштуваннях → Провайдер.
3. Гарячі клавіші — три комбінації одночасно: покращення (Ctrl+Shift+E), меню промтів (Ctrl+Shift+Q), undo (Ctrl+Shift+Z). Конфлікти з уже зареєстрованими системними хоткеями підсвічуються одразу.
4. Готово — виділіть текст у будь-якій програмі, натисніть хоткей, спостерігайте магію.

Після onboarding'у: tray-іконка → Settings → вкладка Промти. Створіть кілька промтів під свої сценарії: «виправ помилки», «переклади на англійську», «зроби формальнішим», «скороти до 100 слів», «поясни простіше» тощо.

Системний трей

Після запуску капібара з'являється в системному треї біля годинника. Hover — підказка CapyBro (якщо активний OpenRouter, за замовчуванням) або CapyBro · Ollama (якщо локальний провайдер). Між запусками хоткея у застосунку немає головного вікна — все доступно через трей.

• Лівий клік на іконці → відкриває вікно Налаштувань.
• Правий клік на іконці → контекстне меню з трьома пунктами: Налаштування, Історія, Вийти. «Вийти» запускає graceful shutdown — pending writes flush, in-flight HTTP запити скасовуються чисто.

Вікно налаштувань — чотири вкладки в сайдбарі

• Налаштування — провайдер, API-ключ, дефолтна модель, хоткеї, автозапуск, Pro-ліцензія, експериментальні прапори, Danger zone (Скидання).
• Промти — керування бібліотекою промтів і вибір дефолтного. Pro-користувачі також отримують браузер Наборів промтів тут.
• Історія — останні 50 покращень (видима коли тоглер Історії увімкнений — за замовчуванням так). Пошук, копіювання назад оригіналу або результату, видалення окремих записів або очищення всього.
• Статистика — Pro-фіча, видима всім, але locked для free tier з teaser-панеллю. Headline цифри, breakdown по моделях, графік активності за 30 днів, Reset.

У footer-і сайдбара — версія + посилання capybro.app і (якщо ви на Ollama) маленький outlined «Ollama» pill, щоб ви завжди знали, який бекенд активний.

Усі хоткеї реєструються через Win32 RegisterHotKey з MOD_NOREPEAT, тому працюють глобально поверх будь-якої програми. Конфлікти з системними / іншими утилітами визначаються одразу: onboarding-візард і Налаштування → Загальне підсвічують конфліктний хоткей червоним.

Створюйте/редагуйте свої сценарії: виправити помилки, перекласти, скоротити, формальніше, дружніше, technical-style, marketing-tone тощо. Кожен промт може мати:

• Власну модель (override default для саме цього промту — спершу увімкніть «Модель для кожного промту» в Додаткових функціях).
• Окрему модель по провайдеру — якщо у вас налаштовані і OpenRouter, і Ollama, промт запам'ятовує різну модель для кожного.
• Diff preview перед застосуванням (увімкнено за замовчуванням — можна вимкнути per-prompt або глобально, якщо хочете instant paste).

Меню промтів (Ctrl+Shift+Q)

Toast зі списком ваших промтів. Стрілки + Enter для вибору, Esc для скасування, цифри 1-9 як швидкий доступ. Popover автоматично закривається коли клік йде в інший процес (foreground-window polling).

Набори промтів (Pro)

Вкладка Промти → справа вгорі кнопка Набори промтів. Перегляньте 5 курованих наборів — Юридичний / Маркетинг / Академічний / Code review / Бізнес — по ~10 промтів кожен (~50 загалом). Натисніть Встановити, щоб скопіювати промти набору у вашу бібліотеку; конфлікти імен отримують суфікс 2 / 3, щоб нічого з ваших існуючих не перезаписалось. Бейдж «Встановлено» позначає набори, які ви вже додали.

CapyBro v2.0 підтримує два бекенди — переключаються однією галочкою у Налаштуваннях → Провайдер:

• OpenRouter (хмара, за замовчуванням) — швидко, широкий вибір моделей (GPT-4o, Claude, Gemini, Llama тощо), pay-as-you-go. Потрібен API-ключ з openrouter.ai/keys.
• Ollama (локально) — для тих, хто категорично не хоче відправляти текст у хмару. Запустіть ollama, завантажте будь-яку модель (ollama pull gemma3), натисніть «Оновити моделі» — весь pipeline працює офлайн.

Як перемкнути на Ollama

1. Встановіть Ollama і запустіть ollama serve (зазвичай auto-start після інсталяції).
2. У терміналі: ollama pull gemma3 (або будь-яку іншу модель з бібліотеки).
3. Налаштування → Провайдер → ✓ «Використовувати локальну модель (Ollama)». CapyBro робить health-check: якщо ollama serve не запущений, з'являється тост-попередження і галочка повертається в OpenRouter.
4. Налаштування → Локальні моделі (Ollama) → натисніть кнопку оновлення. З'явиться список тегів які ви pull-ули. Виберіть один.
5. Готово — Ctrl+Shift+E працює як завжди, але через локальний backend.

Вкладка Історія

Увімкнено за замовчуванням. Зберігає оригінал / результат / промт / модель / час останніх 50 запусків. Вкладка Історія має поле пошуку (debounce 150 мс), записи згруповані по Сьогодні / Вчора / Цього тижня / Раніше, і детальний viewer з кнопками-іконками copy для оригіналу і результату. Видалити окремий запис можна з шапки деталей, або очистити все кнопкою «Очистити все».

Вимикається в Налаштування → Додаткові функції → зніміть галочку «Історія». Файл: ~/.ai_text_improver_v2_history.json.

Експорт історії (Pro)

Зверху вкладки Історія — кнопка Експорт. Вибір CSV (зручно для таблиць: Timestamp, Original, Improved, Prompt, Model, HotkeyKind) або JSON (повна структура). Корисно для архівування, передачі команді або зовнішнього аналізу патернів редагування.

Diff preview

Порівняння оригіналу + AI-результату side-by-side з підсвічуванням змін перед тим, як щось потрапить до документа. Три дії: Прийняти (вставити), Перегенерувати (повторити з тим самим промптом), Відхилити (скасувати + відновити буфер). Зручно для довгих текстів, де одним поглядом не побачиш що змінилося.

Увімкнено за замовчуванням для всіх промптів — стандартних і кастомних. Вимкнути per-prompt можна чекбоксом у редакторі промптів, або глобально через master-toggle у Налаштування → Додаткові функції.

Редагувати результат (toggle справа зверху): перемикає праву панель з read-only diff на редаговане текстове поле. Підправ AI-результат вручну — і Прийняти збереже саме твою відредаговану версію (не сирий AI-вихід).

Streaming-тост

Потокове відображення генерації — видно як AI типує. Не блокує вашу роботу — можете продовжувати робити що завгодно, поки AI генерує. Кнопка ✕ скасовує запит миттєво. Перемикач у Налаштування → Додаткові функції.

Pro — одноразова покупка ($9 через Gumroad). Розблоковує п'ять фіч на додаток до безкоштовної версії. Кожна з них видима користувачам free tier — з маленьким outlined «Pro» pill — щоб ви бачили, що саме отримуєте. Клік по locked-дії показує тост з посиланням на сторінку покупки.

1. Експорт історії у CSV / JSON

Згадано вище. Експорт всіх 50 записів історії в один клік у CSV (для таблиць) або JSON (повна структура).

2. Резервне копіювання й відновлення налаштувань

Налаштування → Загальне → картка Резервне копіювання. Збереже весь конфіг — промти, моделі, хоткеї, мову, прапори — у портативний JSON-файл, який можна перенести на іншу машину або зберегти як знімок перед експериментами. Важливо: бекап НЕ містить ваш API-ключ і Pro-ліцензію (з міркувань безпеки і портативності — це per-machine). Відновлення зберігає поточну ліцензію цієї машини, тож сам бекап залишається портативним.

3. Хоткей перемикання моделей

Налаштування → Загальне → картка Переключення моделей. Закріпіть 2–3 моделі у слотах, далі натискайте Ctrl+Shift+M (можна переприв'язати) будь-де, щоб циклічно перемикатись між ними. Окремі набори по провайдеру: OpenRouter має свій набір закріплених моделей, Ollama — свій, перемикання провайдера зберігає обидва. Працює під час виконання запиту — хоткей обходить single-in-flight guard, тож якщо модель «гальмує», можна миттєво повторити з іншою.

4. Преміум набори промтів

П'ять курованих наборів по ~10 промтів кожен (~50 загалом): Юридичний, Маркетинг, Академічний, Code review, Ділове листування. Кожен промт трьома мовами (English / Українська / Русский). Браузити і встановлювати — з вкладки Промти → справа вгорі кнопка Набори промтів. Встановлення зливається з вашою бібліотекою — конфлікти імен отримують суфікс 2 / 3, тож ваш кастомний набір ніколи не перезаписується.

5. Статистика використання

Четверта вкладка в Налаштуваннях. Три картки: Огляд (загальна кількість покращень, total characters, total spent, дата активності з), По моделях (run-count + витрати по моделях), Активність 30 днів (барчарт по днях). Статистика записується безумовно для кожного успішного покращення — це лише лічильники, без тексту — тож дані є навіть коли тоглер Історії вимкнено. Файл: ~/.ai_text_improver_v2_stats.json. Reset — кнопка у картці Огляд.

Як активувати

1. Купіть ключ на Gumroad — див. розділ pricing на capybro.app.
2. Gumroad надішле вам ліцензійний ключ на email після покупки.
3. Налаштування → Загальне → картка Pro-ліцензія → вставте ключ в єдине поле вводу → Активувати. Email ніде вводити не потрібно — пошта покупця приходить з Gumroad автоматично і показується під статусом «Pro активовано».
4. Якщо ключ валідний, миттєво з'являється бейдж «✓ Pro активовано», у заголовку вікна світиться «Supporter», і всі п'ять Pro-фіч розблоковуються.

CapyBro по-замовчуванню збирає ZERO телеметрії — жодних analytics, crash reporting, опитувань. Усі мережеві запити — це лише ваші запити до OpenRouter (один HTTPS-call на хоткей). Більше нічого нікуди не йде.

Маскування PII (експериментально)

Налаштування → Додаткові функції → Маскування PII автоматично замінює перед відправкою у модель: email → <<EMAIL_n>>, телефони → <<PHONE_n>>, URLs → <<URL_n>>, кредитні картки → <<CARD_n>>, IBAN → <<IBAN_n>>, ПІБ (heuristic) → <<NAME_n>>. Після відповіді AI оригінальні значення підставляються назад — модель ніколи не бачить ваших реальних PII.

У CapyBro три незалежні сховища — налаштування, історія і статистика. У кожного з них всередині застосунку є власна кнопка скидання в один клік. Видаляти файли руками не потрібно.

Скинути налаштування (найчастіший випадок)

Налаштування → Загальне → проскрольте вниз → Danger zone → Скинути налаштування. З'явиться діалог підтвердження. На ТАК відбувається три речі одразу:

• Файл конфігу перезаписується дефолтами — промти, хоткеї, мова, списки моделей, експериментальні прапори, всі ресетяться.
• Ваш OpenRouter API-ключ видаляється з Windows Credential Manager.
• Ваша Pro-ліцензія (якщо була) деактивується — бейдж «Supporter» зникає, Pro-фічі знову блокуються.

Очистити історію

Налаштування → Історія → Очистити все. Очищує JSON з 50 записами. Перед дією — діалог підтвердження.

Скинути статистику

Налаштування → Статистика → Скинути статистику (зверху картки Огляд). Обнуляє всі лічильники і bucketed-дані. Pro-only — вкладка видима всім, але дія скидання потребує активної ліцензії.

Вимкнути автозапуск

Налаштування → Загальне → Система → зніміть «Запускати з Windows». Прибирає запис в реєстрі HKCU\Software\Microsoft\Windows\CurrentVersion\Run\CapyBroV2. Стан галочки сам по собі — частина конфігу, тож Reset не торкнеться запису автозапуску якщо ви його перед тим увімкнули.

Знову побачити onboarding-візард

Reset не повертає onboarding-візард — прапор «onboarding виконано» теж є в дефолтному конфігу, що пишеться при Reset. Якщо хочете справді свіжий first-run, закрийте застосунок (трей → Вийти), відкрийте ~/.ai_text_improver_v2_config.json у текстовому редакторі, знайдіть "OnboardingCompleted": true і встановіть false. Перезапустіть — візард з'явиться знову.

Хоткей не реагує

1. Перевірте, чи цей хоткей не зайнятий іншою утилітою (наприклад, Snipping Tool Ctrl+Shift+S конфліктує).
2. Налаштування → Загальне → блок «Гарячі клавіші». Конфлікт підсвічується червоним з підказкою.
3. Змініть на щось унікальне типу Ctrl+Alt+Shift+E.

AI повертає переклад замість виправлення (або навпаки)

Відкрийте промт у Налаштування → Промти і перепишіть його експліцитніше («Виправ помилки тією ж мовою, не перекладай»). Модель робить те, що каже промт — якщо промт неоднозначний, модель вирішує за вас.

Toast зник, але новий текст не з'явився

• Перевірте, чи у цільовій програмі є фокус на текстовому полі. CapyBro вставляє через clipboard + Ctrl+V — поле має приймати paste.
• Деякі sandbox'овані додатки (UWP / WSA) блокують keyboard automation. Результат вже у вашому clipboard — вставте Ctrl+V вручну.

Як скасувати невдале покращення

Натисніть Ctrl+Shift+Z одразу після небажаного результату. CapyBro поверне оригінал з in-memory кешу (або з файлу історії, якщо вона ввімкнена). Працює один раз — для давніших покращень відкрийте вкладку Історія і натисніть іконку copy-original на потрібному записі.

Попередження «Невідомий видавець» при встановленні

Інсталятор зараз непідписаний (SmartScreen accumulation period). Сейф — натисніть «Додатково» → «Все одно виконати». Або зачекайте, поки інсталятор підпишуть сертифікатом.

Settings вікно не відкривається

• Іконка у треї повинна бути жива (не Windows-сіра). Якщо сіра — додаток впав. Перезапустіть з Start menu.
• Лог: %USERPROFILE%\.ai_text_improver_v2*.log — там буде stack trace.

Чи працює на Windows 10?

Так, мінімальна вимога — Windows 10 1809 (для WPF / DPI awareness). Більшість фіч прозоро деградують на старіших білдах (Mica → solid background).

Чи працює на macOS / Linux?

Ні. Залежить від Win32 API (RegisterHotKey, SendInput, Credential Manager, NotifyIcon). Порт можливий через інший stack (Avalonia + alternative tray + keyring), але це переписаний від нуля проєкт.

Цікаво, як CapyBro виглядає на тлі інших AI-інструментів для тексту? Side-by-side порівняння з таблицями фіч і інструкціями переходу:

• CapyBro проти Grammarly — безкоштовна open-source альтернатива, що працює у будь-якому Windows-додатку, а не лише у браузері та MS Office.
• CapyBro проти ChatGPT Desktop — ті самі моделі (GPT, Claude, Gemini через OpenRouter), але доступні за глобальною гарячою клавішею, а не в одному chat-вікні.
• CapyBro проти Slashit App — open-source альтернатива AppSumo lifetime deal, з локальним режимом Ollama для приватності.

• Проєкт: capybro.app · GitHub repo · Releases
• API провайдер: OpenRouter · API docs
• Локальна LLM: Ollama · Бібліотека моделей