README

Транскрибируйте аудио и видео через RARUS Echo из терминала, PHP-приложений и AI-агентов. Готовый CLI включает PHP runtime и инструменты подготовки аудио из видео.

SDK в статусе beta покрывает текущую версию API: асинхронная транскрибация, диаризация, таймкоды, 13 языков и автоопределение. PHP SDK поддерживает PSR-3/7/17/18 и автоматическое обнаружение HTTP-клиента.

Скачать

Готовые пакеты — в Latest Release. Прямые ссылки всегда указывают на последний стабильный релиз.

В Latest доступны все четыре бинарных пакета CLI и SHA256SUMS. Скачивание, целостность и публичная установка проверены для стабильного 0.5.0. Выбор явной версии и обновление — в руководстве по установке.

Платформа	Архитектура	Скачать
Linux	amd64	rarus-echo-linux-amd64.tar.gz
Linux	arm64	rarus-echo-linux-arm64.tar.gz
macOS	arm64 (Apple Silicon)	rarus-echo-macos-arm64.tar.gz
Windows	amd64	rarus-echo-windows-amd64.zip

Установка

Скачайте пакет через curl, проверьте SHA-256 и распакуйте весь комплект. PHP, Composer и Docker устанавливать не нужно. Выполняйте команды в новом пустом каталоге.

Linux amd64 / arm64

Для ARM64 замените имя архива на rarus-echo-linux-arm64.tar.gz.

archive=rarus-echo-linux-amd64.tar.gz
curl -fL -o "$archive" "https://github.com/mesilov/rarus-echo-php-sdk/releases/latest/download/$archive" &&
curl -fL -o SHA256SUMS https://github.com/mesilov/rarus-echo-php-sdk/releases/latest/download/SHA256SUMS &&
sha256sum --check --ignore-missing SHA256SUMS &&
mkdir rarus-echo && tar -xzf "$archive" -C rarus-echo &&
./rarus-echo/rarus-echo --version

macOS arm64

archive=rarus-echo-macos-arm64.tar.gz
curl -fL -o "$archive" "https://github.com/mesilov/rarus-echo-php-sdk/releases/latest/download/$archive" &&
curl -fL -o SHA256SUMS https://github.com/mesilov/rarus-echo-php-sdk/releases/latest/download/SHA256SUMS &&
grep '  rarus-echo-macos-arm64.tar.gz$' SHA256SUMS | shasum -a 256 -c &&
mkdir rarus-echo && tar -xzf "$archive" -C rarus-echo &&
./rarus-echo/rarus-echo --version

Windows amd64 — PowerShell

$ErrorActionPreference = 'Stop'
$archive = 'rarus-echo-windows-amd64.zip'
curl.exe -fL -o $archive "https://github.com/mesilov/rarus-echo-php-sdk/releases/latest/download/$archive"
if ($LASTEXITCODE -ne 0) { throw 'Archive download failed' }
curl.exe -fL -o SHA256SUMS https://github.com/mesilov/rarus-echo-php-sdk/releases/latest/download/SHA256SUMS
if ($LASTEXITCODE -ne 0) { throw 'Checksum download failed' }
$record = @(Get-Content SHA256SUMS | Where-Object { $_ -match '^[a-fA-F0-9]{64}  rarus-echo-windows-amd64\.zip$' })
if ($record.Count -ne 1) { throw 'Missing or duplicate checksum' }
if ((Get-FileHash $archive -Algorithm SHA256).Hash -ne ($record[0] -split '  ')[0]) { throw 'Checksum mismatch' }
New-Item -ItemType Directory -Path rarus-echo | Out-Null
Expand-Archive -LiteralPath $archive -DestinationPath rarus-echo
.\rarus-echo\rarus-echo.exe --version

Обновление, PATH, ограничения платформ и диагностика запуска — в руководстве по установке. Сохраняйте libexec/, metadata и лицензии рядом с бинарником: они нужны для работы полного пакета.

Первый запуск

Нужны API key и User ID сервиса Echo. Из каталога распакованного пакета:

cd rarus-echo
./rarus-echo install
./rarus-echo doctor
./rarus-echo queue --json
./rarus-echo submit /path/to/audio.ogg --language=ru --wait --output=transcript.txt

В PowerShell используйте .\rarus-echo.exe вместо ./rarus-echo и свой путь к аудио. install сохраняет подключение, API key вводится скрыто. submit также принимает локальное видео и сам подготавливает аудиодорожку. Для сохранения аудио без транскрибации и подключения: rarus-echo extract-audio video.mp4. Конфигурация подключения · Команды и опции CLI.

Команды CLI

Команда	Назначение
`rarus-echo install`	Настроить подключение и сохранить приватный конфиг.
`rarus-echo doctor`	Проверить конфиг, доступ к Echo и готовность медианабора.
`rarus-echo extract-audio <file>`	Сохранить аудио рядом с видео с тем же базовым именем, без отправки в Echo.
`rarus-echo queue`	Показать сводную информацию об очереди транскрибации.
`rarus-echo submit <files>...`	Отправить один или несколько аудио- или видеофайлов на транскрибацию.
`rarus-echo status <file-id>`	Показать статус транскрибации файла по UUID.
`rarus-echo transcript <file-id>`	Получить результат транскрибации файла по UUID.
`rarus-echo list`	Показать список публичных команд.
`rarus-echo help <command>`	Показать справку выбранной команды, например `rarus-echo help submit`.
`rarus-echo completion`	Вывести скрипт автодополнения для оболочки.

Скрытая служебная команда rarus-echo _complete выдаёт подсказки скрипту автодополнения; обычно её вызывает оболочка автоматически. Аргументы, опции и примеры — в полном справочнике CLI.

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

Вопросы и ошибки: GitHub Issues. Лицензия: MIT.

mesilov / rarus-echo-php-sdk

Package info

Security

Statistics