Крок за кроком

Налаштуйте LinguoAI на своєму комп’ютері.

Тут показано, куди натиснути, що ввести і як зрозуміти, що все готово. Почніть із кроку 1. Додаткові можливості розташовані внизу сторінки.

Одноразове налаштування

Встановлення на комп’ютер із Windows

Вам потрібен комп’ютер із Windows, інтернетом і кількома гігабайтами вільного місця. Готового інсталятора поки немає. Наступні кроки допоможуть встановити програму. Вміти програмувати не потрібно.

  1. 01

    Встановіть дві допоміжні програми

    Відкрийте меню «Пуск» Windows, введіть PowerShell і відкрийте програму. Копіюйте наступні рядки по одному й після кожного натискайте Enter. Чекайте завершення встановлення, перш ніж вводити наступний рядок.

    PowerShell
    winget install --id Python.Python.3.11 --exact --source winget
    winget install --id Gyan.FFmpeg --exact --source winget

    Python запускає LinguoAI. FFmpeg читає й записує відео. Якщо Windows запитає підтвердження, переконайтеся, що запит стосується цього встановлення.

    Готово? Обидва встановлення повідомляють про успіх або про те, що програму вже встановлено. Тепер закрийте PowerShell.

  2. 02

    Завантажте й розпакуйте LinguoAI

    Завантажте ZIP-файл. У папці завантажень натисніть на нього правою кнопкою миші й виберіть «Видобути все». Потім відкрийте розпаковану папку.

    Завантажити LinguoAI 2.2.2 ↓

    Ви в потрібній папці, якщо бачите файл pyproject.toml і папку linguoai .

  3. 03

    Відкрийте потрібну папку

    У відкритій папці натисніть адресний рядок угорі. Введіть powershell і натисніть Enter. Відкриється нове вікно. Скопіюйте в нього ці три команди перевірки по одній:

    PowerShell
    py -3.11 --version
    ffmpeg -version
    ffprobe -version

    Ви побачите Python 3.11 і ще два повідомлення з номерами версій. Якщо з’явиться «не знайдено», перш ніж продовжити, скористайтеся допомогою нижче.

  4. 04

    Налаштуйте LinguoAI

    Залишайтеся в цьому вікні. Копіюйте рядки по одному й натискайте Enter. Після кожного рядка чекайте, поки знову можна буде вводити текст. Першого разу завантажаться великі файли.

    PowerShell
    py -3.11 -m venv .venv
    .\.venv\Scripts\python.exe -m pip install --upgrade pip
    .\.venv\Scripts\python.exe -m pip install torch --index-url https://download.pytorch.org/whl/cpu
    .\.venv\Scripts\python.exe -m pip install -e ".[desktop]"

    Усе завершилося без помилок? Налаштування готове. Воно потрібне лише один раз.

  5. 05

    Відкрийте програму

    Скопіюйте цей рядок у те саме вікно:

    PowerShell
    .\.venv\Scripts\python.exe -m linguoai

    Відкриється вікно LinguoAI. Не закривайте PowerShell, поки користуєтеся LinguoAI.

Спробуйте зараз

Ваше перше перекладене відео

Для початку візьміть коротке відео з чітким мовленням, наприклад на 30 секунд.

  1. На вкладці „Start“ натисніть „Datei …“ і виберіть відео.
  2. Виберіть потрібну мову в полі „Zielsprache“ . Початкову мову можна визначити автоматично.
  3. Для першої спроби виберіть «Google Translate · online» і «Edge TTS · online».
  4. Відкрийте «Erweitert» → «Leistung». У полі «Hardware für Spracherkennung» виберіть «Nur CPU». Потім поверніться до «Start». Решту налаштувань можна залишити без змін.
  5. Натисніть „Verarbeitung starten“ . Під час першого запуску LinguoAI також завантажить модель розпізнавання мовлення. Це може тривати певний час.
  6. Коли з’явиться „FERTIG“ натисніть „Video öffnen“ . Натисніть „Ordner öffnen“ — відкриється папка з відео й обома файлами субтитрів.

Якщо щось не виходить

Як відкрити LinguoAI наступного разу?

Знову відкрийте розпаковану папку LinguoAI. В адресному рядку вгорі введіть powershell. Виконайте лише команду з кроку 5. Повторювати встановлення не потрібно.

«winget» не знайдено

Встановіть або оновіть «Інсталятор програм» від Microsoft у Microsoft Store. Потім знову відкрийте PowerShell і повторіть крок 1.

Відкрити інструкцію Microsoft ↗
Python або FFmpeg не знайдено

Закрийте PowerShell і відкрийте знову, як у кроці 3. Якщо це не допомогло, перезавантажте комп’ютер і перевірте три рядки ще раз. Для цієї інструкції потрібен встановлений Python 3.11.

Команда повідомляє про помилку

Поки не виконуйте наступний рядок. Спочатку перевірте, що ви перебуваєте в розпакованій папці з файлом pyproject.toml і що ви скопіювали весь рядок. Збережіть точний текст помилки на випадок, якщо знадобиться допомога.

Обробка триває довго або не завершується

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

Інші можливості: Linux, локальні голоси й не лише
Linux

Потрібні Python 3.10+ і FFmpeg

# FFmpeg, ffprobe und Tkinter über die Paketverwaltung installieren.
# Im entpackten Projektordner:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install torch --index-url https://download.pytorch.org/whl/cpu
python -m pip install -e ".[desktop]"
ffmpeg -version
ffprobe -version
python -m linguoai

Чотири способи отримати голосову доріжку

Порівняти голоси

«Власний голос» може означати різні речі. Це порівняння допоможе вам зробити правильний вибір.

Edge TTS

Простий спосіб почати роботу з готовими голосами з каталогу Microsoft.

Онлайн · Ні, голос каталогу

gTTS

Швидкий Google Voice через Google Translate Text-to-Speech з голосовим кодом.

Онлайн · Ні, код мови

Piper

Швидкий локальний вихід за допомогою існуючої або самонавченої моделі ONNX.

Місцевий · CPU, опціонально CUDA

Chatterbox V2

Переймає вокальний характер і манеру говорити з короткого, чистого запису.

Довідковий голос · Рекомендовано GPU

Додайте Piper локально

Встановіть у тому ж віртуальному середовищі, а потім завантажте відповідний голос:

.\.venv\Scripts\python.exe -m pip install -e ".[desktop,piper]"
New-Item -ItemType Directory -Force ".\Stimmen"
.\.venv\Scripts\python.exe -m piper.download_voices --download-dir ".\Stimmen" de_DE-thorsten-medium

Piper: ONNX плюс відповідний JSON, додатковий ідентифікатор динаміка та регульована швидкість розмови.

Власний контрольний голос із Chatterbox

Через залежності аудіо/факела рекомендується спеціальне середовище Python-3.11:

py -3.11 -m venv .venv-chatterbox
.\.venv-chatterbox\Scripts\python.exe -m pip install --upgrade pip
.\.venv-chatterbox\Scripts\python.exe -m pip install -e ".[desktop,voice-clone]"
.\.venv-chatterbox\Scripts\python.exe -m linguoai
  • 6-10 секунд, одна людина, невелика реверберація, без музики чи фонового шуму.
  • Завантаження моделі приблизно 3,7 ГБ; CPU можливий, але дуже повільний для довших відео.
  • Рідна установка є експериментальною; Colab або Linux є більш надійними для вирішення проблем з аудіопакетами.

Для повторюваних процесів

Командний рядок

Цей приклад локально перекладається на NLLB і використовує модель Piper. Для автоматизації доступні ті ж налаштування, що і в GUI.

Власний вихід і шляхи моделі

PowerShell · Piper локально
.\.venv\Scripts\python.exe -m linguoai `
  --input "C:\Videos\quelle.mp4" `
  --output "C:\Videos\quelle.de.mp4" `
  --language de `
  --service nllb `
  --device cpu `
  --nllb-device cpu `
  --tts-engine piper `
  --tts-device cpu `
  --piper-model "C:\Stimmen\de_DE-thorsten-medium.onnx" `
  --piper-config "C:\Stimmen\de_DE-thorsten-medium.onnx.json"

Переглянути всі варіанти: .\.venv\Scripts\python.exe -m linguoai --help

Python-Wheel

Готовий пакет для існуючого середовища Python; FFmpeg все ще потрібен.

Навантаження Wheel ↓

python -m pip install ".\linguoai-2.2.2-py3-none-any.whl[desktop]"
python -m linguoai

Розумно розподіляйте обчислювальну потужність

CPU і GPU не є рішенням «все або нічого».

Whisper, NLLB і місцевий голос можна розмістити окремо. Тож ви можете почати з малого та встановити на GPU лише ту частину, яка справді виграє від цього.

«Автоматично» перевіряє CUDA і в іншому випадку повертається до CPU.

Важливо: вибір «GPU» не інсталює CUDA автоматично.
  • NLLB і Chatterbox

    Потрібне відповідне видання CUDA PyTorch.

    Вибір PyTorch ↗
  • Faster-Whisper

    Крім того, потрібні CUDA-12-cuBLAS і cuDNN 9 у системному шляху.

  • Piper

    Використовує ONNX Час виконання: onnxruntime-gpu встановити замість версії CPU.

Додатковий варіант для швидшого розпізнавання на CPU

Parakeet чи Whisper?

Parakeet · 25 мов

NVIDIA Parakeet v3 розпізнає 25 європейських мов. Додатковий адаптер sherpa-onnx працює локально на CPU, за замовчуванням у чотири потоки.

Картка моделі NVIDIA ↗

Whisper · універсальний

Faster-Whisper залишається типовим варіантом: автоматичне визначення мови, ширший вибір мов і обробка на CPU або GPU.

Faster-Whisper ↗

Модель primeline спеціалізується на німецькій мові. Для неї оберіть німецький профіль із відповідним ONNX-експортом; для кількох європейських мов — профіль NVIDIA. Перевага у швидкості чи якості не гарантується без порівняння на ваших файлах.

Налаштувати Parakeet

Встановіть додатковий пакет і підготуйте папку із сумісною моделлю. Моделі не завантажуються автоматично.

.\.venv\Scripts\python.exe -m pip install -e ".[parakeet]"
.\.venv\Scripts\python.exe -m linguoai --help

Використовуйте повну папку моделі sherpa-onnx з encoder, decoder, joiner і файлом токенів. Для німецького експорту також збережіть зовнішній файл encoder, якщо він є частиною моделі.

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

Моделі й налаштування sherpa-onnx ↗ · Картка моделі primeline ↗

Завантаження → обробка → отримання

Працюйте у браузері.

Video Studio

Для користувачів, які вже отримали доступ до Studio. Увійдіть і завантажуйте відео безпосередньо в браузері.

Обробка на сервері. Можливості перекладу поки обмежені; повний робочий процес ще не підтверджено.

Обліковий запис Google не потрібен. Якщо у вас немає доступу до Studio, виберіть Google Colab або версію Desktop.

Google Colab

Вебінтерфейс Colab уже приймає завантажені файли та шляхи до файлів Google Drive. Він обробляє відео на активній машині Colab і дозволяє завантажити відео та субтитри. Результати також можна зберегти у вашому Drive.

Повний інструментарій

Всі функції детально.

Картотеки та замовлення
  • Обробка окремого відео або всіх відео, які безпосередньо містяться в папці.
  • Входи: MP4, MKV, MOV, AVI, WEBM і M4V; Редакції: MP4, MKV або MOV.
  • Автоматична пропозиція виводу, імена без колізій і контрольоване перезапис.
  • Перебіг за файлом, поточний крок роботи, скасування та технічний журнал.
  • Одиночна й пакетна обробка: завантажте кілька відео або введіть шляхи до файлів MyDrive, по одному в рядку. Файли Piper і зразок голосу можна завантажити або вказати їхні шляхи в MyDrive.
Транскрипція з Faster-Whisper
  • Моделі tiny поки large-v3, додатково власні значення моделі.
  • Автоматично визначати вихідну мову або встановлювати як код мови.
  • CPU, NVIDIA-CUDA або автоматичний вибір; int8, float16 і float32, які можна налаштувати.
  • Аудіорозділи, що перекриваються, справжні часові зсуви та очищення дублікатів сегментів.
  • Довжина фрагментів, перекриття та номер робочого елемента за допомогою додаткових параметрів або CLI.
Переклад і захист тексту
  • NLLB-200 локальний, Google Translate без ключа, DeepL-SDK або Gemini.
  • Необов’язковий резервний варіант лише після явного вибору – інакше буде зв’язано лише з одним постачальником.
  • URL, адреси електронної пошти, валюти, одиниці та відсотки захищені під час перекладу.
  • Тайм-аути, обмежені повтори та кеш для ідентичних текстових розділів.
  • За бажанням Gemini виправляє розшифровку Whisper без зміни ідентифікаторів сегментів або часу.
  • Власні моделі, сумісні з NLLB, виправлені версії, коди FLORES, обмеження партій і маркерів.

Модель NLLB-600M за умовчанням відповідає CC-BY-NC-4.0, є дослідницькою моделлю, а не сертифікованим виробничим перекладом. Завжди перевіряйте результати.

Хронометраж, тон і експорт
  • Нормалізуйте кожен кліп до 48 кГц моно PCM і розташуйте його з точністю вибірки.
  • Прискорення надто довгого мовлення в межах встановленого ліміту.
  • Попередження при швидкому розгоні; контрольована помилка замість незрозумілого результату.
  • Точна кінцева тривалість, прийняті метадані/розділи та, якщо можливо, незмінний відеопотік.
  • Група результатів Atomic з нового відео, оригінального SRT і перекладу SRT.
Де обробляються ваші дані
  • NLLB · Piper · Chatterbox

    Після завантаження в обраний вами термін. У Colab це означає всередині тимчасової віртуальної машини Google.

  • Google · DeepL · Gemini

    Отримувати лише текстові розділи, якщо їх вибрано або як явно активований запасний варіант.

  • Edge TTS · gTTS

    Надсилайте кожну перекладену репліку на дубляж до відповідної мовної онлайн-служби.

  • Захищений веб-інтерфейс Gradio із довільним паролем на сеанс.
  • Додатковий кеш моделі та атомарна копія результату в Google Drive.
  • Шляхи приводу залишаються в межах MyDrive; Диск не є загальнодоступною папкою для завантажень.

Тимчасові результати не будуть опубліковані, доки відео та обидва субтитри не будуть завершені. Скасування, обмежені повторні спроби, захищені шляхи призначення та відредаговані ключі API дозволяють уникнути неприємних сюрпризів.

НЕОБОВ’ЯЗКОВО

Власна адреса через Cloudflare Tunnel.

За SHARE_PROVIDER = "gradio" динамічне посилання створюється автоматично. Google Drive необов’язковий.

Cloudflare за бажанням

Лише для власної постійної адреси: налаштуйте іменований Cloudflare Tunnel зі своїм доменом і сервісом http://127.0.0.1:7860. Це не загальнодоступний сервер LinguoAI.

У Notebook установіть SHARE_PROVIDER = "cloudflare", укажіть власний хост у CLOUDFLARE_TUNNEL_HOSTNAME і збережіть CLOUDFLARE_TUNNEL_TOKEN у Colab Secrets. Ніколи не публікуйте токен.

Cloudflare: за замовчуванням 95 MB на завантаження. Gradio: до 5 GB на файл. Для великих відео використовуйте Google Drive. Тимчасові посилання trycloudflare.com не використовуються через відсутність підтримки SSE.

Відкрийте посібник Colab