Якщо вам потрібна повноцінна версія для ПК з додатковими робочими процесами, ознайомтеся з BasiliskLLM (автономний додаток та мінімальний модуль для NVDA). AI-Hub залишається повнофункціональним варіантом для використання в NVDA.

AI-Hub

AI-Hub — це додаток для NVDA, який підключає ваш екранний зчитувач до декількох API великих мовних моделей (LLM). Використовуйте його для написання текстів, узагальнення, допомоги з перекладом, візуалізації (зображення та знімки екрана), голосових запитань, транскрипції та діалогів додаткових інструментів (TTS, OCR тощо) — не виходячи з NVDA.

Назва пакета цього додатка в NVDA залишається openai (для сумісності з існуючими інсталяціями). Назва, що показується у меню та налаштуваннях, — AI-Hub.

Огляд функцій

Чат у спеціальному головному діалозі з історією, системними підказками та вибором моделі/облікового запису.
Зображення та документи як вкладення з файлів; URL-адреси до віддалених файлів із перевіркою типу, що відповідає обраному постачальнику.
Розумна вставка у полі для введення запиту: вставляйте файли з буфера обміну, шляхи з тексту або одне посилання (також доступно з контекстного меню поля запиту). Ctrl+V використовує ту ж логіку, якщо фокус знаходиться на полі запиту.
Збереження та історія розмов із можливістю перейменування, видалення та повторного відкриття.
Поставити запитання з будь-якого місця (без початкової клавіші): призначте жест у розділі Жести вводу → AI-Hub, щоб записати питання, надіслати його та прослухати або прочитати відповідь.
Глобальний опис: знімок екрана (NVDA+E) або область об’єкта навігатора (NVDA+O) з надсиланням в чат.
Підменю Інструменти (у меню NVDA → AI-Hub): утиліти для конкретних постачальників, такі як TTS, OCR, перетворення мовлення в текст, аудіосервіс Lyria та керування моделями Ollama.
Параметри Міркування / веб-пошук з’являються лише тоді, коли поточна модель їх підтримує (залежить від постачальника).

Цей додаток не має власного механізму перевірки оновлень. Оновлення здійснюються через офіційний магазин додатків NVDA, якщо ви встановлюєте додаток звідти. Якщо ви встановлюєте додаток вручну зі сторінки випусків, встановлюйте новіші збірки .nvda-addon таким самим чином.

Підтримувані постачальники

Налаштуйте одного або декількох постачальників у NVDA в розділі Параметри → Налаштування → AI-Hub. Кожен постачальник може мати кілька іменованих облікових записів (API-ключі, а також, за необхідності, організацію або базову URL).

Постачальник	Роль
OpenAI	Моделі GPT та пов’язані моделі; офіційні діалоги для транскрипції та перетворення тексту в мовлення
DeepSeek	DeepSeek API (сумісний з OpenAI)
Налаштований OpenAI	Будь-який HTTP-API, сумісний з OpenAI (налаштована базова URL-адреса + ключ)
Ollama	Локальні моделі через кінцеву точку, сумісну з OpenAI; інструмент для управління моделями
Mistral AI	Mistral / Pixtral; Voxtral: інструменти для синтезу мовлення (TTS), оптичного розпізнавання символів (OCR) та перетворення мовлення в текст
OpenRouter	Багато моделей сторонніх виробників під одним ключем
Anthropic	Claude
xAI	Grok
Google	Gemini; інструмент Lyria 3 Pro

Додаток може отримувати ключі API з змінних середовища, якщо вони встановлені (наприклад, OPENAI_API_KEY, DEEPSEEK_API_KEY, MISTRAL_API_KEY, OPENROUTER_API_KEY, ANTHROPIC_API_KEY, XAI_API_KEY, GEMINI_API_KEY / GOOGLE_API_KEY та інші). Інтерфейс налаштувань залишається основним місцем для керування обліковими записами.

Сервіси перетворення мовлення в текст (транскрипція)

Для транскрипції з мікрофона / файлу у рамках основного робочого процесу (а не за допомогою окремого інструменту транскрипції OpenAI) ви можете вибрати один із варіантів: whisper_cpp (локальний), openai (API Whisper) або mistral у розділі Запис налаштувань AI-Hub.

Встановлення

Відкрийте сторінку випусків додатка.
Завантажте найновіший пакет .nvda-addon.
Встановіть його з меню NVDA Інструменти → Магазин додатків (або відкрийте файл у Провіднику та підтвердьте встановлення).

Початкове налаштування

Відкрийте NVDA → Параметри → Налаштування.
Виберіть категорію AI-Hub.
У розділі Облікові записи API натисніть Додати обліковий запис....
У діалозі облікового запису виберіть постачальника, введіть назву облікового запису та заповніть необхідні поля (API-ключ для більшості постачальників; базову URL-адресу для Custom OpenAI та Ollama, при цьому для Ollama початково використовується локальна адреса http://127.0.0.1:11434/v1, якщо поле порожнє).
Збережіть, потім за бажанням додайте ще облікові записи, відредагуйте наявні або видаліть непотрібні зі списку облікових записів.
За потреби налаштуйте Звуковий відгук, Відповідь у чаті, Додатково / температуру генерації, а також Автоматичне збереження розмови (початково увімкнено).

Доки хоча б один обліковий запис постачальника не буде налаштовано, при відкритті головного діалогу з’явиться запит на додавання ключів у налаштуваннях AI-Hub.

Оновлення зі старіших версій «Open AI»

Якщо ви використовували старішу версію цього додатка:

Налаштування переносяться зі старого розділу конфігурації OpenAI до AIHub. Ви не повинні втратити свою конфігурацію.
Файли даних (розмови, сховище ключів, вкладення) переносяться з папки openai у вашій директорії користувацької конфігурації NVDA до папки aihub.

Вам не потрібно переміщувати файли вручну, якщо ви не використовуєте спеціальні налаштування.

Меню NVDA: AI-Hub

У меню NVDA ви знайдете пункт AI-Hub (з зазначенням встановленої версії у назві). Доступні опції:

Документація — відкриває посібник користувача у вашому браузері (doc\uk\readme.html).
Головний діалог додатка… — відкриває діалог чату (початково NVDA+G).
Історія розмов… — керування збереженими чатами.
Інструменти — підменю, що об’єднує утиліти OpenAI, Mistral, Google та Ollama (див. нижче).
Репозиторій GitHub / BasiliskLLM — швидкі посилання.

Головний діалог

Відкрийте за допомогою NVDA+G або пункту Розмова… у меню AI-Hub.

Що ви можете робити

Спілкуйтеся з обраною моделлю; переглядайте повідомлення за допомогою клавіатурної навігації та контекстних меню (наприклад, j / k для переходу між повідомленнями, коли фокус знаходиться в області повідомлень — див. підказки на екрані щодо активного поля).
Додавайте локальні зображення або документи та вставляйте URL-адреси файлів, якщо це підтримується постачальником. Перед відправленням може з’явитися попередження про типи файлів, що не підтримуються поточним постачальником.
Вставте (файл або текст) з контекстного меню у полі запиту або за допомогою Ctrl+V. Додаток може додавати файли, вставляти текстові шляхи або розглядати окремий URL як вкладення, якщо це можливо.
Записуйте фрагменти аудіо, додавайте аудіофайли та використовуйте TTS для тексту запиту, якщо модель це підтримує.
Escape закриває головний діалог (якщо не відкрито жодного блокуючого модального вікна).
Ctrl+R вмикає/вимикає запис з мікрофона (якщо це можливо).
F2 перейменовує поточну збережену розмову (якщо вона вже існує у сховищі).
Ctrl+N відкриває новий екземпляр головного діалогу (сесію).

Параметри, що залежать від моделі

Деякі елементи керування з’являються або застосовуються лише для певних моделей:

Процес міркування («міркування») для моделей, які його демонструють; послідовний процес міркування відображається окремо від кінцевої відповіді, якщо API передбачає таке розмежування.
Рівень складності міркування та відповідні параметри налаштування, якщо постачальник підтримує різні рівні.
Веб-пошук лише для моделей, які підтримують функцію веб-пошуку.

Доступність може змінюватися у міру оновлення API постачальників; інтерфейс показує поточну вибрану модель.

Системна підказка

Системна підказка визначає поведінку моделі. Початково надається підказка, пристосована для допомоги з доступністю; її можна редагувати, скинути через контекстне меню та, за бажанням, зберегти останню використану підказку (доступно в меню налаштувань). Системна підказка використовує токени так само, як і будь-який інший запит.

Історія розмов

Використовуйте Історію розмов… у меню AI-Hub або призначте жест у розділі Жести вводу → AI-Hub.

Ви можете створювати списки, відкривати, перейменовувати, видаляти та створювати розмови. У головному діалозі F2 і Ctrl+N допомагають керувати поточним сеансом.

Автозбереження

Якщо в налаштуваннях увімкнено функцію Автозбереження розмови (початково), додаток зберігає (або оновлює) збережену розмову після кожної завершеної відповіді помічника і може зберегти стан розмови при її закритті, якщо є що зберегти. Ви також можете зберегти розмову через контекстне меню у полі Повідомлення. Якщо автозбереження вимкнено, скористайтеся ручним збереженням, коли потрібно зберегти стан розмови.

Поставити запитання (голосом)

Ця команда не має початкової комбінації. Призначте її в розділі Жести вводу → AI-Hub.

Перше натискання: почати запис.
Друге натискання під час запису: зупинити та надіслати.
Якщо відповідь відтворюється як аудіо, натисніть ще раз, щоб зупинити відтворення.

Режими:

Прямий аудіоввід — якщо обрана модель підтримує аудіоввід, ваш запис може бути надісланий як аудіо без окремого етапу транскрипції.
Спочатку транскрипція, потім чат — якщо ні, вибрана система транскрипції обробляє запис, після чого текст надсилається до моделі чату.

Якщо фокус знаходиться у головному діалозі, використовується його поточна модель; в іншому випадку додаток обирає відповідну модель серед налаштованих постачальників.

Підменю інструментів

Пункт «Інструменти» у меню AI-Hub відкриває діалоги, згруповані за постачальниками (для кожного з них може знадобитися відповідний обліковий запис API):

Область меню	Інструмент
Mistral	Voxtral TTS…, OCR…, Мовлення в Текст…
Google	Lyria 3 Pro…
OpenAI	TTS…, Транскрипція / Переклад…
Ollama	Менеджер моделей…

Якщо для постачальника інструмента не налаштовано жодного облікового запису, додаток запропонує вам додати його в налаштуваннях AI-Hub.

Глобальні команди

Усі стандартні жести можна змінити в NVDA → Параметри → Жести вводу → AI-Hub.

Жест	Дія
`NVDA`+`G`	Відкрити головний діалог AI-Hub
`NVDA`+`E`	Зробити знімок екрана та описати його (додати зображення до сеансу)
`NVDA`+`O`	Описати область поточного об’єкта навігатора
(початково немає жесту)	Історія розмов. Призначити в меню «Жести вводу» → «AI-Hub».
(початково немає жесту)	Поставити запитання (запис / надсилання / зупинка аудіо). Призначити в «Жестах вводу» → «AI-Hub».
(початково немає жесту)	Увімкнути/вимкнути запис мікрофона та транскрипцію. Призначити в «Жестах вводу» → «AI-Hub».

Де зберігаються дані

Робочі файли, індекс збережених розмов, об’єднаний файл accounts.json та вкладення зберігаються у вашому каталозі конфігурації користувача NVDA, у папці aihub (після перенесення з openai). Тимчасові файли зберігаються у підпапці tmp і видаляються у відповідний момент (наприклад, після завершення роботи додатка або закриття діалогу).

Усунення несправностей (коротко)

«Обліковий запис не налаштовано» — додайте ключ API для постачальника, який ви вибрали в налаштуваннях AI-Hub.
Постачальник відхиляє вкладення — Перевірте тип і розмір файлу; спробуйте скористатися іншою моделлю або постачальником, який підтримує потрібний вам тип медіафайлу.

Для проблем і внесків скористайтеся посиланням репозиторій GitHub у меню AI-Hub.

Переклад: Георгій Галас.