Документация · версия 1.0.0

Программа для ЭВМ «Тембр»

Руководство администратора

Установка, настройка и эксплуатация

Наименование программы«Тембр» — программа расшифровки аудио- и видеозаписей в текст с разделением по говорящим
Версия1.0.0
Класс ПО07.04 «Средства распознавания и синтеза речи»
ПравообладательООО «Веб 3.0», ИНН 5027321593, ОГРН 1235000127218
Техническая поддержкаveb3.0@yandex.ru, по будням с 10:00 до 19:00 (МСК)
Сайтhttps://tembr.web3-0.ru
Дата документа17.10.2026

Содержание

  1. Назначение и состав
  2. Требования к оборудованию и программному окружению
  3. Состав дистрибутива
  4. Установка на Linux
  5. Первый запуск: заведение администратора 5а. Лицензия: активация, проверка, отвязка, корпоративная поставка
  6. Учётные записи и роли
  7. Расписание работы
  8. Защищённое соединение (HTTPS) и сертификат
  9. Служба и автозапуск
  10. Параметры запуска и переменные окружения
  11. Где хранятся данные
  12. Обновление
  13. Резервное копирование и восстановление
  14. Журналы и диагностика
  15. Удаление
  16. Типичные неполадки
  17. Учётная запись для проверки экспертами
  18. Дополнительные платформы: Windows и macOS
  19. Обращение в поддержку

1. Назначение и состав

«Тембр» — сервис расшифровки записей, который работает внутри организации. Он ставится на сервер (или рабочую станцию) организации; пользователи открывают его в браузере, отправляют записи, получают текст с разметкой говорящих. Записи и результаты хранятся только на этом сервере, в интернет и в сторонние сервисы не передаются. В интернет программа обращается только для проверки лицензии — на сервер ООО «Веб 3.0» в России (раздел 5а); корпоративная поставка (тариф «Enterprise», для компьютеров без интернета) работает без ключа, и обращений нет вовсе.

Состав программы:

частьназначение
transcriber_web.pyвеб-сервер: страницы, вход, приём файлов, выдача результатов
transcriber_core.pyядро: чтение звука, распознавание, разметка говорящих, хранение
transcriber_jobs.pyочередь задач: расчёт идёт по одной записи
transcriber_users.pyучётные записи, пароли, сеансы
transcriber_schedule.pyрасписание работы и журнал нагрузки
transcriber_export.pyвыгрузка в Word (.docx) и субтитры (.srt)
transcriber_platform.pyвыбор файла и описание оборудования
transcriber_window.pyнастольное окно (используется в поставке для macOS)
transcriber_license.py, transcriber_ed25519.pyлицензия: ключ, активация, проверка подписи жетона
web/интерфейс: HTML, CSS, JavaScript без внешних библиотек
models/веса моделей распознавания и разметки говорящих, тексты их лицензий

Распознавание речи выполняется локально моделью large-v3 (движок faster-whisper на Linux и Windows), разметка говорящих — локальной моделью pyannote. Авторы и лицензии моделей показаны на странице «О программе».

Базы данных нет: каждая расшифровка — отдельный файл JSON в папке пользователя, от имени которого работает сервис (раздел 11).

2. Требования к оборудованию и программному окружению

2.1. Операционная система

Основная платформа — Linux:

  • Astra Linux Special Edition 1.8 (x86-64);
  • РЕД ОС 7.3 и 8.

Проверка 13.10.2026 (протокол — 40-протоколы/), облачные серверы Рег.облака, 4 vCPU Intel Xeon (Cascadelake), 4 ГБ ОЗУ + 4 ГБ подкачки:

РЕД ОС 7.3.6 «Муром»Astra Linux SE 1.8.2 «Орёл»
ядро / glibc6.1.143 / 2.286.1.124 / 2.36
установка из архива без сетида, 71 сда, 34 с
расшифровка с ролями без сетида, 104,3 сда, 105,5 с
служба systemdставитсяставится и запускается
веб-интерфейсработаетработает

Сеть на время установки и расчёта отключалась на уровне ядра (unshare -n). Результат расшифровки на обеих ОС совпал слово в слово. Замкнутая программная среда Astra в облачном образе выключена — работу с включённой ЗПС проверить на машине заказчика. РЕД ОС 8 отдельно не проверялась.

Дополнительные платформы — Windows 10/11 x64 и macOS 13+ на процессорах Apple — описаны кратко в разделе 18.

2.2. Оборудование

минимальнорекомендуется
процессор4 ядра8 ядер
оперативная память8 ГБ16 ГБ
видеокартане обязательнаNVIDIA с видеопамятью от 8 ГБ
диск40 ГБ60 ГБ

Штатный режим — расчёт на процессоре. Видеокарта NVIDIA ускоряет расчёт в несколько раз; её драйвер и библиотеки CUDA — собственность NVIDIA, в поставку программы не входят и устанавливаются заказчиком при желании.

Ориентиры по времени (замер 25.09.2026, Apple M4, модель large-v3): на графическом процессоре расчёт с разделением по говорящим занимает около 0,3 длительности записи, на процессоре — около 1,7 (час записи — полтора–два часа; без разделения по говорящим — около часа). Подсказка на экране новой расшифровки называет время по тому, есть ли видеокарта. На стендах проверки (13.10.2026, 4 vCPU Intel Xeon, режим процессора, модель large-v3 с разделением по говорящим) запись 41,0 с считалась 104,3 с на РЕД ОС 7.3.6 и 105,5 с на Astra Linux SE 1.8.2 — около 2,5 длительности записи. При 4 ГБ ОЗУ без подкачки расчёт завершается ядром по нехватке памяти, поэтому минимум — 8 ГБ.

Место на диске складывается из: программы с окружением (PyTorch — около 2,5 ГБ, модели — около 3 ГБ), присылаемых записей (до 5 ГБ каждая, хранятся только на время расчёта), копий звука для плеера (около 30 МБ на час записи) и расшифровок (около 100 КБ на час).

2.3. Программное окружение

  • Python 3.10–3.13. Устанавливать заранее не нужно: установщик берёт его из дистрибутива (офлайн-вариант) или ставит рядом с программой, не трогая системный.
  • systemd — для работы в виде службы (без него программу можно запускать вручную).
  • Права root нужны только для однократных действий: включение loginctl enable-linger (автозапуск без входа в систему) и, при необходимости, драйвер NVIDIA. Сама программа ставится и работает от имени обычного пользователя, в его домашней папке.

2.4. Сеть

  • Порт сервиса по умолчанию — 7870/TCP; при работе по HTTPS служба слушает 8443/TCP, а старый адрес на 7870 переадресует на https (раздел 8.3).
  • Для расчёта выход в интернет программе не нужен: веса моделей входят в дистрибутив, служба при их наличии запрещает обращения к внешним хранилищам моделей (переменная TRANSCRIBER_OFFLINE=1).
  • Для лицензии нужен исходящий доступ по HTTPS (порт 443) к tembr.web3-0.ru: при активации и затем раз в сутки; без связи лицензия действует 14 дней. Корпоративной поставке (Enterprise) доступ в интернет не нужен совсем (раздел 5а.4).
  • Если выход в интернет — через прокси-сервер организации, проверка лицензии использует системные переменные HTTPS_PROXY / HTTP_PROXY (стандартный механизм Python): их нужно задать в окружении службы. Если выхода нет совсем — корпоративная поставка (Enterprise) без сети.
  • Для установки без офлайн-склада нужен доступ в интернет (см. 4.3).

2.5. Рабочие места пользователей

Браузер текущей версии: Chrome, Edge, Safari или Firefox; поддерживаются и телефоны. Установка программ на рабочие места не требуется. Извлечение звука из видео в браузере перед отправкой работает только по HTTPS (раздел 8).

3. Состав дистрибутива

Дистрибутив для Linux — архив tembr-1.0.0-linux.zip (в общем виде tembr-<версия>-linux.zip). Внутри всё лежит в папке tembr/ без номера версии — чтобы новая версия распаковывалась поверх прежней.

файл или папканазначение
transcriber_*.py, web/программа
models/веса моделей и папка models/лицензии/ с текстами лицензий
склад/офлайн-склад: Python, пакеты, чтение звука (может отсутствовать — см. 4.3)
tools/uv-x86_64, tools/uv-aarch64установщик Python для архитектур x86-64 и ARM64
УСТАНОВИТЬ.shустановщик
служба.shустановка, удаление и проверка службы systemd
проверка-видеокарты.pyпроверка: на чём считает программа
сертификат.pyвыпуск самоподписанного сертификата
КАК ПОДНЯТЬ СЕРВЕР.mdкраткая памятка по установке
token.txtслужебный файл; при поставке с весами моделей заполнять не нужно

Номер установленной версии:

venv/bin/python transcriber_web.py --version

Выводит строку вида Тембр 1.0.0, ООО «Веб 3.0». Тот же номер — на странице «О программе».

4. Установка на Linux

4.1. Подготовка (с правами root, один раз)

  1. Завести обычную учётную запись, от имени которой будет работать сервис (без прав sudo). Далее она называется «пользователь службы».

  2. Включить автозапуск пользовательских служб без входа в систему:

    sudo loginctl enable-linger <пользователь службы>
  3. Только для ускорения на видеокарте: установить драйвер NVIDIA и убедиться, что nvidia-smi показывает карту.

  4. Только для установки без офлайн-склада (4.3): установить заголовки FFmpeg и компилятор.

    Astra Linux (и другие на основе Debian):

    sudo apt install build-essential pkg-config libavformat-dev \
         libavcodec-dev libavdevice-dev libavutil-dev libswscale-dev \
         libswresample-dev libavfilter-dev

    РЕД ОС: пакеты ffmpeg-devel (или libavformat-devel) и gcc.

    Выпуск 1.0.0 поставляется со складом: при установке из архива на x86-64 эти пакеты не нужны.

  5. Открыть в межсетевом экране порт сервиса, чтобы коллеги могли подключиться к серверной установке (7870/TCP; при HTTPS — также 8443/TCP).

    РЕД ОС:

    sudo firewall-cmd --permanent --add-port=7870/tcp && sudo firewall-cmd --reload

    Astra Linux (если включён ufw):

    sudo ufw allow 7870/tcp

4.2. Установка (от имени пользователя службы)

unzip tembr-1.0.0-linux.zip -d ~
cd ~/tembr
bash УСТАНОВИТЬ.sh

На минимальных образах РЕД ОС и Astra нет unzip. Распаковать архив можно самим Python (cd ~ && python3 -m zipfile -e tembr-1.0.0-linux.zip .) или поставить unzip: sudo dnf install unzip (РЕД ОС), sudo apt install unzip (Astra).

Установщик выполняет шесть шагов и пишет о каждом:

шагчто происходит
[0/6]проверяет, что файлы программы на месте, и сообщает, есть ли офлайн-склад
[1/6]находит подходящий Python (3.10–3.13) или берёт/ставит Python 3.12 рядом с программой
[2/6]создаёт окружение venv в папке программы
[3/6]ставит PyTorch
[4/6]ставит чтение звука (PyAV)
[5/6]ставит движок распознавания и веб-сервер
[6/6]проверяет, что веса моделей на месте, и ставит службу (раздел 9)

В конце выводится «Установка завершена.» Если веса моделей найдены, установщик пишет «веса моделей установлены — интернет для работы не нужен».

Системные папки и системный Python установщик не изменяет: всё ставится внутрь ~/tembr.

4.3. Варианты установки: офлайн и из сети

Офлайн (рекомендуется). Если в архиве есть папка склад/ и машина имеет архитектуру x86-64, установщик берёт Python, все пакеты и чтение звука из архива и в сеть не обращается. Чтение звука в складе собрано со своей сборкой FFmpeg под лицензией LGPL, поэтому заголовки FFmpeg и компилятор не нужны. PyTorch в складе — вариант для процессора.

Склад входит в выпуск 1.0.0: архив tembr-1.0.0-linux.zip (3,4 ГБ), внутри папка склад/. Расчёт при полностью отключённой сети проверен 13.10.2026 на РЕД ОС 7.3 и Astra Linux SE 1.8.

Ускорение на видеокарте после офлайн-установки ставится отдельно, при разовом доступе в сеть и установленном драйвере NVIDIA:

venv/bin/python -m pip install --force-reinstall torch torchaudio \
    --index-url https://download.pytorch.org/whl/cu126

(cu126, cu128 или cu130 — по версии CUDA, которую показывает nvidia-smi).

Из сети. Если склада нет (или машина не x86-64), установщик:

  • ищет системный Python 3.10–3.13, а если его нет — ставит Python 3.12 рядом с программой (установщик uv лежит в архиве);
  • скачивает PyTorch: при наличии nvidia-smi — сборку с поддержкой видеокарты (перебирая cu126, cu128, cu130), иначе — для процессора;
  • собирает чтение звука против системного FFmpeg (нужны заголовки — 4.1, п. 4). Если собрать не удалось, установщик предупредит и поставит готовый пакет, в котором есть компоненты под лицензией GPL; для поставки в составе продукта такой вариант не используется;
  • скачивает остальные библиотеки.

Для этого варианта нужен доступ к PyPI и download.pytorch.org на время установки (около 2,5 ГБ).

4.4. Проверка установки

cd ~/tembr
venv/bin/python transcriber_web.py --version
venv/bin/python -c "import transcriber_core as c; print(c.где_модели())"
venv/bin/python проверка-видеокарты.py
  • вторая команда должна начинаться с «привезены в дистрибутиве: …»;
  • проверка-видеокарты.py печатает, что видит PyTorch, и в конце строку «ИТОГ: …» — на видеокарте или на процессоре идёт разметка говорящих.

Результат на стендах 13.10.2026: установщик отработал без сети от обычного пользователя (РЕД ОС 7.3.6 — 71 с, Astra Linux SE 1.8.2 — 34 с); вторая команда вывела «привезены в дистрибутиве: /home/expert/tembr/models (в сеть за ними не ходим)»; разметка говорящих — на процессоре (cpu), видеокарты на стендах нет. Снимки экрана — в протоколе проверки (40-протоколы/).

5. Первый запуск: заведение администратора

Программа не открывается в сеть без учётных записей: пока не заведён ни один пользователь, наружу отдаётся только страница входа.

  1. Запустите службу (если она ещё не запущена):

    systemctl --user start transcriber
  2. Найдите в журнале службы код первого запуска — шесть знаков:

    journalctl --user -u transcriber -n 50

    Рядом будет текст «Пользователей ещё нет. Откройте адрес выше и заведите администратора. Понадобится код первого запуска». Код действует до перезапуска программы.

  3. Откройте в браузере http://<адрес сервера>:7870/. Страница называется «Первый запуск». Введите имя, пароль (не короче шести знаков) и «Код первого запуска», нажмите «Завести администратора».

  4. Программа войдёт под новым администратором. Все записи, сделанные до появления учётных записей, становятся его.

Код нужен, чтобы администратором стал тот, у кого есть доступ к серверу, а не тот, кто первым открыл адрес.

При локальном запуске (сервис слушает только 127.0.0.1) код не спрашивается, а пока пользователей нет, вход не требуется вовсе.

5а. Лицензия: активация, проверка, отвязка, корпоративная поставка

Без действующей лицензии программа открывается и показывает готовые расшифровки, но новые расшифровки не запускаются. Лицензией управляет администратор на странице «Лицензия» (пункт бокового меню); обычные пользователи видят только её состояние.

Тарифы и места. Ключ определяет тариф («Личный» или «Команда»), число мест и срок — один год. Место — один компьютер либо одна учётная запись на серверной установке. Серверная установка занимает все места ключа, а учётных записей на ней можно завести не больше, чем мест. Нужны и сервер, и отдельные компьютеры с программой — это два ключа. Тариф «Enterprise» ключом не оформляется: по договору организация получает отдельную корпоративную поставку (раздел 5а.4).

5а.1. Активация

  1. Заведите администратора (раздел 5) и войдите под ним.
  2. Откройте «Лицензия», вставьте ключ из письма вида TMBR-XXXX-XXXX-XXXX-XXXX в поле «Ключ из письма» и нажмите «Активировать».
  3. Программа отправит на сервер лицензий ООО «Веб 3.0» (https://tembr.web3-0.ru/api/lic, Россия) ключ, отпечаток сервера (хэш системного идентификатора, а не сам идентификатор), имя компьютера и номер версии. В ответ придёт жетон лицензии, подписанный ключом ООО «Веб 3.0»; программа проверяет подпись сама и хранит жетон в ~/Transcriber/лицензия.json.
  4. Состояние сменится на «Активна»; на странице появятся тариф, число мест, владелец, дата окончания («Действует до») и имя компьютера с пометкой «серверная установка».

Записи, тексты расшифровок, имена говорящих, имена файлов и учётные записи на сервер лицензий не передаются.

Если сервер лицензий отказал, программа показывает его ответ на странице. Причины отказа: ключа нет, он не оплачен, срок истёк или свободных мест не осталось.

5а.2. Проверка

Раз в сутки, если есть связь, программа сама обновляет жетон — в фоне, без задержки страниц и расчёта. Кнопка «Проверить сейчас» делает это сразу. Без связи последний жетон действует 14 дней; после этого пользователи увидят «Лицензию не удавалось проверить больше 14 дней…», и достаточно восстановить связь — проверка пройдёт сама при следующей попытке расшифровки.

Программа отклоняет жетон, если часы сервера переведены назад больше чем на сутки: держите на сервере точное время.

5а.3. Отвязка и перенос на другой сервер

На странице «Лицензия» в блоке «Обслуживание» нажмите «Отвязать» и подтвердите. Место освободится на сервере лицензий, ключ можно активировать на другом компьютере; на этом новые расшифровки перестанут запускаться. Отвязывайте до переустановки или замены сервера: жетон привязан к отпечатку компьютера и на другой машине недействителен.

5а.4. Корпоративная поставка (тариф Enterprise, без интернета)

Для организаций, где у компьютеров нет интернета, ООО «Веб 3.0» по договору Enterprise выпускает корпоративную поставку — дистрибутив, собранный для этой организации. Устанавливается он так же, как обычный (раздел 4), но:

  • ключ не нужен: активации, ежедневной проверки и отвязки нет, к серверу лицензий программа не обращается;
  • на странице «Лицензия» написано «Корпоративная поставка для <название организации> по договору Enterprise: ключ и интернет не нужны»; то же название стоит на странице «О программе» рядом с номером версии;
  • название берётся из файла поставка.json в папке программы — файл не удаляйте и не правьте: без него программа станет обычной поставкой и попросит ключ;
  • число компьютеров и срок использования определяются договором; корпоративную поставку не передают за пределы организации.

Отдельный компьютер без интернета в обычной поставке. Если по договору лицензию нужно выдать такому компьютеру файлом: на странице «Лицензия» перепишите «Код устройства» и передайте его в ООО «Веб 3.0» (veb3.0@yandex.ru); полученный файл загрузите в поле «Файл лицензии». Состояние сменится на «Активна», в строке проверки — «офлайн-лицензия, связь с сервером не нужна». Файл действует только на том компьютере, для которого выпущен.

5а.5. Окончание срока и продление

По истечении срока новые расшифровки не запускаются; список, страницы записей, плеер и выгрузка остаются доступны. Продление оформляется на сайте https://tembr.web3-0.ru или по договору; ключ остаётся прежним, к сроку прибавляется год. После оплаты нажмите «Проверить сейчас» (для лицензии, полученной файлом, — загрузите новый файл). Корпоративная поставка продлевается по договору Enterprise.

6. Учётные записи и роли

6.1. Роли

пользовательадминистратор
отправлять записи и получать расшифровкидада
видеть записитолько своивсе, с именем заказчика
очередьсвоё место и число задач впереди, без имёнвсе задачи с именами
отменять задачисвоилюбые (чужие — с подтверждением)
ограничение по расписаниюдействуетне действует
страница «Люди и расписание»нетда

Чужая запись для обычного пользователя выглядит как несуществующая («Запись не найдена»). О том, что администратор видит все записи, пользователь предупреждён на странице входа.

6.2. Управление пользователями

Страница «Люди и расписание» (пункт меню виден только администратору).

  • Блок «Кто может входить» — список пользователей с отметкой «администратор» и кнопками:
    • «Новый пароль» — задать пароль; все сеансы этого человека закрываются;
    • «Удалить» — удалить учётную запись. Его расшифровки остаются на сервере и видны администратору. Последнего администратора удалить нельзя.
  • Блок «Завести человека» — поля «Имя», «Пароль», флажок «Администратор», кнопка «Завести». Пароль показывается открыто, чтобы его можно было передать человеку; после заведения программа один раз повторяет его на экране.

Правила:

  • пароль — не короче шести знаков;
  • на серверной установке учётных записей можно завести не больше, чем мест в лицензии; при превышении программа ответит «По лицензии на этом сервере можно завести N учётных записей…» (раздел 5а);
  • имена не различаются по регистру: «Иванов» и «иванов» — одно имя;
  • самостоятельной регистрации и восстановления пароля по почте нет намеренно: пароль задаёт только администратор;
  • сеанс живёт 14 дней.

Пароли хранятся в виде хэша PBKDF2-HMAC-SHA256 с индивидуальной солью и 240 000 итераций; файл users.json доступен только владельцу (права 600).

6.3. Забыт пароль администратора

  1. Остановите службу: systemctl --user stop transcriber.

  2. От имени пользователя службы выполните:

    cd ~/tembr
    venv/bin/python transcriber_web.py --reset-admin <имя>

    Без имени используется «администратор». Если такого пользователя нет, он будет заведён.

  3. Программа напечатает временный пароль. Запустите службу, войдите с ним и сразу задайте свой на странице «Люди и расписание».

Все прежние сеансы этого пользователя закрываются; событие записывается в ~/Transcriber/migration.log.

7. Расписание работы

Блок «Часы работы» на странице «Люди и расписание»:

  • флажок «Ограничивать по часам»;
  • дни недели Пн … Вс;
  • поля «С» и «До»;
  • кнопка «Сохранить».

По умолчанию ограничение включено: понедельник–пятница, с 09:00 до 22:00 по времени сервера.

Вне этих часов новые расшифровки не принимаются; пользователь видит сообщение вида «Сервис работает по будням с 09:00 до 22:00. Уже поставленные расшифровки досчитаются и ночью — приходите утром за результатом.» Задачи, уже стоящие в очереди и считающиеся, досчитываются. Администратор может ставить задачи в любое время. Праздничные дни не учитываются.

Блок «Ночная нагрузка» показывает сводку журнала нагрузки: сколько задач всего и вне рабочих часов, сколько часов шёл расчёт, какие форматы записей присылают, какую долю видео браузер разобрал сам, сколько места занимают копии звука для плеера.

8. Защищённое соединение (HTTPS) и сертификат

8.1. Зачем

Без сертификата сервис работает по http://, и:

  • пароли пользователей идут по сети открытым текстом (об этом предупреждает страница входа);
  • браузер не даёт извлекать звук из видео перед отправкой — видео передаётся целиком.

8.2. Где взять сертификат

Предпочтительно — сертификат на имя сервера от центра сертификации организации: тогда браузеры пользователей доверяют ему без предупреждений. Подходят любые файлы сертификата и ключа в формате PEM.

Временный вариант — самоподписанный сертификат:

cd ~/tembr
venv/bin/python сертификат.py [имя-или-адрес …]

Нужная скрипту библиотека cryptography есть в складе и ставится установщиком; в закрытом контуре отдельно ставить её не нужно.

Без аргументов скрипт выписывает сертификат на имя и адреса этой машины; срок действия — 825 дней. Файлы сертификат.crt и ключ.key скрипт кладёт рядом с программой (в ~/tembr) и печатает полные пути к ним.

Самоподписанному сертификату браузер не доверяет и показывает предупреждение. Чтобы его не было, корневой сертификат нужно распространить на рабочие места средствами организации.

8.3. Запуск с сертификатом

Служба сама поднимает https, если рядом с программой лежат сертификат.crt и ключ.key: положите файлы (или выпустите их сертификат.py) и переустановите службу:

cd ~/tembr
bash служба.sh установить

Служба слушает https на порту 8443 (порт 443 пользовательской службе недоступен — порты ниже 1024 на Linux открыты только root); адрес для коллег — https://<имя сервера>:8443/. Файлы проверяются при каждой установке службы, поэтому повторный запуск служба.sh установить или установщика https не снимает.

Ручной запуск — с теми же ключами:

venv/bin/python transcriber_web.py --host 0.0.0.0 --port 8443 \
    --cert /путь/к/сертификат.crt --key /путь/к/ключ.key \
    --redirect-from 7870 --no-browser
  • --cert и --key нужны оба; если файла нет, программа скажет об этом и не запустится;
  • --redirect-from 7870 — на прежнем порту поднимается переадресация на https://, сохраняющая путь: старые ссылки пользователей продолжают работать.

Проверка: адрес https://<имя сервера>:8443/ открывается; на странице входа вместо предупреждения о пароле написано «Соединение защищено сертификатом…»; при отправке видео появляется строка «Готовлю запись к отправке…».

9. Служба и автозапуск

Установщик ставит пользовательскую службу systemd transcriber.service (файл ~/.config/systemd/user/transcriber.service) и включает её в автозапуск. Служба:

  • запускает venv/bin/python transcriber_web.py --host 0.0.0.0 --no-browser из папки программы, то есть слушает все сетевые интерфейсы на порту 7870;
  • работает в серверном режиме (TRANSCRIBER_SERVER=1): записи приходят по сети, окна выбора файла нет;
  • при наличии всех весов в дистрибутиве работает без обращений в интернет (TRANSCRIBER_OFFLINE=1);
  • перезапускается при сбое — не более пяти попыток за минуту, затем останавливается;
  • на остановку даёт две минуты, чтобы корректно завершить текущий расчёт.

Управление:

действиекоманда
запуститьsystemctl --user start transcriber
остановитьsystemctl --user stop transcriber
перезапуститьsystemctl --user restart transcriber
состояниеsystemctl --user status transcriber или bash служба.sh состояние
журналjournalctl --user -u transcriber -n 100 или bash служба.sh журнал
поставить зановоbash служба.sh установить
снятьbash служба.sh удалить

Если loginctl enable-linger не включён, установщик напомнит об этом: без него служба работает, только пока пользователь вошёл в систему.

Если systemd на машине нет, программу запускают вручную:

cd ~/tembr
TRANSCRIBER_SERVER=1 venv/bin/python transcriber_web.py --host 0.0.0.0 --no-browser

Перезапуск и задачи. Очередь хранится в памяти и перезапуск не переживает: стоявшие в очереди задачи нужно отправить заново. Если в момент остановки шла разметка говорящих, а текст уже был распознан, запись сохранится с пометкой «прервана — только текст».

10. Параметры запуска и переменные окружения

10.1. Ключи командной строки transcriber_web.py

ключзначение
--versionпоказать версию и правообладателя
--port ПОРТпорт; по умолчанию 7870 (или значение TRANSCRIBER_PORT)
--host АДРЕСадрес прослушивания; по умолчанию 127.0.0.1 (только этот компьютер), 0.0.0.0 — открыть для сети
--no-browserне открывать браузер при запуске
--cert ФАЙЛсертификат (PEM), включает HTTPS
--key ФАЙЛзакрытый ключ сертификата
--redirect-from ПОРТпереадресация с этого порта по http на https (работает только вместе с --cert)
--reset-admin [ИМЯ]выдать администратору временный пароль; выполнять при остановленной службе

10.2. Переменные окружения

переменнаяназначение
TRANSCRIBER_SERVERсерверный режим: приём записей по сети, без системного окна выбора файла (служба ставит 1)
TRANSCRIBER_PORTпорт по умолчанию вместо 7870
TRANSCRIBER_OFFLINE1 — не обращаться в интернет за моделями; 0 — разрешить, даже если веса привезены (нужно, чтобы скачать модель, которой нет в поставке)
TRANSCRIBER_MODELSпуть к папке с весами моделей, если она лежит не рядом с программой
TRANSCRIBER_MAX_UPLOADпредел размера присылаемого файла в байтах; по умолчанию 5 ГБ (5368709120)
TRANSCRIBER_ENGINEпринудительный выбор движка распознавания (faster); по умолчанию выбирается сам
TRANSCRIBER_DIAR_DEVICEустройство для разметки говорящих: cpu или cuda; по умолчанию выбирается само
TRANSCRIBER_NO_BROWSERто же, что --no-browser
TRANSCRIBER_BRANDслужебная, задаётся службой (тембр); менять не требуется

Переменные службы задаются строками Environment=… в файле службы; после правки — systemctl --user daemon-reload и перезапуск.

10.3. Предел размера и место на диске

Перед приёмом файла программа проверяет свободное место: после приёма на диске должно остаться не менее 2 ГБ. Иначе файл не принимается, а пользователь видит сообщение о нехватке места. Принятая запись удаляется сразу после расчёта (успешного, отменённого или с ошибкой).

11. Где хранятся данные

Все данные — в домашней папке пользователя службы, в ~/Transcriber/. Папка программы (~/tembr) пользовательских данных не содержит.

путьчто это
history/расшифровки, по файлу JSON на запись
audio/копии звука для плеера (.m4a, 64 кбит/с); удаляются вместе с записью
incoming/записи, принимаемые по сети; удаляются после расчёта
uploads/временные файлы для скачивания
users.jsonпользователи и хэши паролей (права 600)
sessions.jsonдействующие сеансы (права 600)
расписание.jsonнастройки расписания
нагрузка.jsonlжурнал нагрузки: приём файлов, начало и конец задач
словарь.jsonсловарь замен (см. 11.1)
лицензия.jsonжетон лицензии и дата последней проверки (права 600) — раздел 5а
migration.logжурнал служебных событий, в том числе --reset-admin
.hf_tokenтокен доступа к хранилищу моделей — нужен, только если весов моделей нет в дистрибутиве
history-backup-*копия истории, которую программа делает перед обновлением формата записей

11.1. Словарь замен

Файл ~/Transcriber/словарь.json исправляет в готовом тексте термины, которые модель устойчиво искажает. Формат — список правил:

[
  {"было": "изи", "стало": "ИЗЗЗИ", "почему": "название организации"}
]

Замены выполняются по целым словам, без учёта регистра, длинные правила раньше коротких. Все сделанные замены записываются в саму расшифровку и показываются пользователю на странице записи («Замены по словарю»). Повреждённый файл словаря игнорируется и не мешает расчёту. Правка в интерфейсе не предусмотрена; изменения действуют для новых расшифровок.

Заносите в словарь только устойчивые ошибки — один и тот же неверный вариант, повторяющийся в разных записях. Разовые описки заносить не нужно: неверная замена хуже отсутствия замены.

12. Обновление

  1. Дождитесь окончания текущих расшифровок (или предупредите пользователей: стоящие в очереди задачи при перезапуске пропадут).

  2. Сделайте резервную копию (раздел 13).

  3. Остановите службу: systemctl --user stop transcriber.

  4. Распакуйте новый архив поверх прежней установки:

    unzip -o tembr-<новая версия>-linux.zip -d ~
  5. Запустите установщик: cd ~/tembr && bash УСТАНОВИТЬ.sh. Существующее окружение venv не пересоздаётся; установщик доставит новые зависимости и заново поставит службу. Повторный запуск обязателен. Если в новом архиве есть склад, установщик и при обновлении в сеть не обращается.

  6. Запустите службу и проверьте версию:

    systemctl --user start transcriber
    venv/bin/python transcriber_web.py --version

Расшифровки, учётные записи, настройки и лицензия лежат в ~/Transcriber и при обновлении не затрагиваются; повторная активация не нужна. При изменении формата записей программа переводит историю на новый формат сама, предварительно сохранив копию в ~/Transcriber/history-backup-<дата>.

Если служба запускалась с HTTPS, проверьте после шага 5, что ключи --cert, --key остались в файле службы (раздел 8.3).

13. Резервное копирование и восстановление

Что копировать: папку ~/Transcriber целиком. Папку программы копировать не нужно — она восстанавливается из дистрибутива.

Как: при остановленной службе или когда расчёт не идёт:

systemctl --user stop transcriber
tar -czf transcriber-backup-$(date +%Y%m%d).tar.gz -C ~ Transcriber
systemctl --user start transcriber

Папки incoming/ и uploads/ содержат только временные файлы, их можно исключить (--exclude=Transcriber/incoming --exclude=Transcriber/uploads).

Восстановление: остановить службу, распаковать архив в домашнюю папку пользователя службы (tar -xzf … -C ~), запустить службу. При восстановлении на другой машине лицензия из копии не действует (она привязана к компьютеру): отвяжите прежний сервер, если он доступен, и активируйте ключ заново (раздел 5а).

Резервная копия содержит записи совещаний и хэши паролей: храните её с той же степенью защиты, что и сам сервер.

14. Журналы и диагностика

источникчто там
journalctl --user -u transcriberвывод программы: адрес запуска, код первого запуска, помеченные прерванные расшифровки, на чём идёт распознавание и разметка (видеокарта или процессор), свободная видеопамять после каждой задачи, ошибки
~/Transcriber/нагрузка.jsonlпо строке на событие: приём файла (формат, размер), начало задачи (длительность записи, вне рабочих часов или нет), конец задачи (время расчёта)
~/Transcriber/migration.logобновление формата истории, сброс пароля администратора
страница «Люди и расписание», блок «Ночная нагрузка»сводка по журналу нагрузки
страница «О программе»версия, откуда берутся веса моделей

Команды для проверки:

cd ~/tembr
venv/bin/python transcriber_web.py --version
venv/bin/python -c "import transcriber_core as c; print(c.где_модели())"
venv/bin/python проверка-видеокарты.py
nvidia-smi -l 5        # загрузка видеокарты во время расчёта

Признак правильной работы на видеокарте: во время определения говорящих загрузка видеокарты (GPU-Util) высокая, а число «видеопамяти свободно» в журнале после задач возвращается к одному и тому же значению.

15. Удаление

  1. Если лицензия будет использоваться на другом компьютере — сначала отвяжите этот на странице «Лицензия» (раздел 5а.3).

  2. Снять службу:

    cd ~/tembr
    bash служба.sh удалить
  3. Удалить папку программы: rm -r ~/tembr.

  4. Данные (~/Transcriber) — расшифровки, звук, учётные записи — сохраняются. Удаляйте их, только если они больше не нужны и сделана резервная копия: rm -r ~/Transcriber. Это действие необратимо.

  5. При необходимости отключить автозапуск для пользователя (root): sudo loginctl disable-linger <пользователь службы>.

16. Типичные неполадки

что видночто делать
Установщик: «Рядом нет файла …»Архив распакован не целиком. Распакуйте заново
Установщик: «Собрать не вышло: не хватает заголовков FFmpeg или компилятора»Установка из сети без склада. Поставьте пакеты из 4.1, п. 4, и запустите установщик снова — или используйте архив со складом
Установщик: «Не удалось скачать установщик Python»Нет доступа в интернет при установке без склада. Используйте архив со складом или поставьте python3.12 из репозитория ОС
Установщик: «весов моделей рядом нет»Архив распакован не целиком: должна быть папка models/ с подпапкой hub/
Установщик: «Чтобы служба поднималась после перезагрузки…»Выполните sudo loginctl enable-linger <пользователь>
«systemd не найден — служба не ставится»Запускайте вручную (раздел 9)
Страница не открывается с другого компьютераПроверьте на самом сервере curl http://127.0.0.1:7870/login. Если отвечает — дело в межсетевом экране или в адресе прослушивания (--host 0.0.0.0)
Наружу открывается только страница входа «Первый запуск»Не заведён администратор. Раздел 5
Не найти код первого запускаjournalctl --user -u transcriber -n 50; после перезапуска службы код новый
Забыт пароль администратораРаздел 6.3
Пользователь видит «Сервис работает … досчитаются и ночью»Нерабочее время по расписанию. Раздел 7
«Файл больше … — столько мы не принимаем.»Предел TRANSCRIBER_MAX_UPLOAD (раздел 10.2). Сначала проверьте свободное место
Файл не принимается из-за места на дискеПосле приёма должно оставаться 2 ГБ. Освободите место
Расчёт идёт очень медленноСчитает процессор. проверка-видеокарты.py; при наличии NVIDIA — поставить PyTorch с CUDA (4.3)
В журнале CUDA out of memoryНе хватило видеопамяти. Временно — TRANSCRIBER_DIAR_DEVICE=cpu; сообщите в поддержку
На экране «Модель распознавания не найдена, а выход в интернет закрыт»Нет весов в models/. Распакуйте дистрибутив целиком или задайте TRANSCRIBER_MODELS
Разметка говорящих требует скачать модель (около 30 МБ)В дистрибутиве нет модели разметки. Нужен разовый доступ в интернет либо полный архив весов
Видео грузятся долго, у пользователя объяснение про «защищённый адрес»Включите HTTPS. Раздел 8
«Нужны оба файла: —cert и —key» / «Не нашёлся сертификат: …»Проверьте пути к файлам сертификата и ключа
«Программа не активирована. Введите ключ лицензии на странице «Лицензия».»Активируйте ключ (раздел 5а.1)
«Нет связи с сервером лицензий. Проверьте интернет и попробуйте ещё раз.»Нет исходящего доступа по HTTPS к tembr.web3-0.ru. Проверьте межсетевой экран; для компьютеров без интернета — корпоративная поставка или файл лицензии (5а.4)
«Срок лицензии закончился…»Продлите лицензию (5а.5)
«Лицензию не удавалось проверить больше 14 дней…»Восстановите связь сервера с tembr.web3-0.ru
«Лицензия выдана для другого компьютера…»Данные перенесены с другой машины. Активируйте ключ заново; при нехватке мест — отвяжите прежний компьютер (5а.3) или напишите в поддержку
«Часы компьютера переведены назад…»Исправьте время на сервере, затем «Проверить сейчас»
«По лицензии на этом сервере можно завести N учётных записей…»Мест в лицензии меньше, чем нужно учётных записей. Докупите места или удалите ненужную учётную запись
Служба в состоянии failed после нескольких перезапусковjournalctl --user -u transcriber -n 100 — причина в последних строках. После устранения: systemctl --user reset-failed transcriber и запуск

17. Проверочный экземпляр для экспертов

Экспертам передаётся дистрибутив версии 1.0.0 для Linux; стенд с выданной учётной записью не используется.

Дистрибутивпапка на СберДиске: https://files.sberdisk.ru/s/orkQXbBfypX94In — архив tembr-1.0.0-linux.zip (3,4 ГБ, со складом и весами моделей, SHA-256 cb39860d93fb97e01078cb60d5990c0902f8bf41910f898e0e244d9c9d4a8ffb), тестовая запись и краткая инструкция ПРОЧТИ-МЕНЯ.txt
Установкаразделы 4.1–4.2
Режимлокальный запуск: venv/bin/python transcriber_web.py, открыть http://127.0.0.1:7870; учётная запись не нужна
Серверный режимэксперт сам заводит администратора на странице первого запуска (раздел 5)
ОС проверкиРЕД ОС 7.3.6 и Astra Linux SE 1.8.2 «Орёл» (13.10.2026, раздел 2.1)
Режим расчётапроцессор, 8 ГБ оперативной памяти
Лицензияключ для экспертов (3 места, на год): передаётся в заявлении (в документации не публикуется)

Тестовая запись — файл совещание-тест.wav (45 с, синтезированная речь, два голоса) рядом с архивом; эксперт может использовать и свои записи. Записи заказчиков в проверочный экземпляр не передаются.

Что можно проверить в серверном режиме под администратором, помимо функций пользователя (Руководство пользователя, раздел 12):

  1. Страница «Люди и расписание»: завести пользователя, задать ему новый пароль, удалить.
  2. Войти под обычным пользователем в другом браузере и убедиться, что чужие записи не видны.
  3. Изменить часы работы и проверить отказ обычному пользователю вне расписания.
  4. Страница «О программе»: версия 1.0.0, правообладатель, авторы и лицензии моделей.
  5. Страница «Лицензия»: состояние «Активна», срок, число мест; для онлайн-лицензии — «Проверить сейчас».

Снимки экранов стендов — в протоколе проверки: 40-протоколы/redos-7.3/ и 40-протоколы/astra-1.8.2/ (служба после первого запуска, список расшифровок, страница записи, «О программе»).

18. Дополнительные платформы: Windows и macOS

Программа одна для всех платформ; различаются только установщики.

Windows 10/11 x64. Дистрибутив — tembr-1.0.0-windows-x64.zip (папка tembr/ внутри) с мастером установки «Тембр» (Inno Setup): по умолчанию программа ставится в папку пользователя (%LOCALAPPDATA%\Тембр), создаёт ярлыки в меню «Пуск» и, по выбору, на рабочем столе, удаляется штатно через пункт «Удалить Тембр». Для серверного режима программа запускается так же, как на Linux:

set TRANSCRIBER_SERVER=1
venv\Scripts\python transcriber_web.py --host 0.0.0.0 --port 7870 --no-browser

Ключи командной строки, переменные окружения, папка данных (C:\Users\<пользователь>\Transcriber) и порядок первого запуска те же, что описаны выше. Служба Windows не поставляется: после перезагрузки сервис запускается вручную.

macOS 13+ на процессорах Apple (M1 и новее). Дистрибутив — tembr-1.0.0-macos-arm64 — образ .dmg с приложением «Тембр». Приложение содержит всё необходимое, включая веса моделей; расчёт идёт без интернета, а для лицензии нужна активация ключа и связь раз в 14 дней (раздел 5а). Оно открывается в собственном окне и предназначено для работы одного пользователя на своём компьютере (запись выбирается кнопкой «Выбрать файл», учётные записи не требуются). Данные хранятся в ~/Transcriber.

19. Обращение в поддержку

veb3.0@yandex.ru, по будням с 10:00 до 19:00 по московскому времени. Сайт: https://tembr.web3-0.ru.

В обращении укажите:

  • вывод venv/bin/python transcriber_web.py --version;
  • операционную систему и её версию (cat /etc/os-release);
  • вывод venv/bin/python проверка-видеокарты.py — если вопрос о скорости;
  • состояние и ключ со страницы «Лицензия» — если вопрос о лицензии;
  • последние строки журнала: journalctl --user -u transcriber -n 200.

Записи совещаний к обращению не прикладывайте.