ElevenLabs CLI
Официальный CLI ElevenLabs: весь API подкомандами, озвучка текста в терминале и голосовые агенты как код с синхронизацией.
- 104 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ключ API открывает платный доступ к аккаунту ElevenLabs, включая удаление агентов.
- Тексты и файлы отправляются на серверы ElevenLabs.
Установка
- Работает в
Ручная установка
brew install elevenlabs/tap/elevenlabsПервая команда из README для macOS и Linux; для остальных систем есть Scoop, `npm install -g @elevenlabs/cli`, скрипт установки и сборка из исходников.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ключ API открывает платный доступ к аккаунту ElevenLabs, включая удаление агентов.
- Тексты и файлы отправляются на серверы ElevenLabs.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CLI написан на Rust и открывает каждый эндпоинт платформы ElevenLabs командой вида `elevenlabs <ресурс> <метод>`. Результат выводится как JSON, таблица, YAML или CSV. Команда `elevenlabs say "текст"` озвучивает строку или stdin и сразу воспроизводит звук через найденный в системе плеер, а флаг `--output` сохраняет файл. Раздел «Агенты как код» хранит голосовых агентов в JSON-файлах проекта: `agents init`, `add`, `push`, `pull`, `test`. Ветки и версии агентов синхронизируются с платформой, схему агента можно нарисовать в терминале или экспортировать в Mermaid без ключа и сети. Для задач Flows (изображения, видео, озвучка) есть команды `create-and-wait`, которые дожидаются результата. В репозитории лежат два скилла для агентов: `say` и `custom-commands`.
Для кого. Разработчикам голосовых ассистентов на ElevenLabs, которые хотят вести агентов в Git и поручать вызовы API Claude Code или Codex.
Подходит, если
- Конфигурация голосового агента правится в репозитории, а затем выкладывается на платформу после просмотра.
- Агент после долгой сборки должен вслух сообщить о готовности.
- Нужна схема агента с ветвлениями и инструментами в виде диаграммы для ревью.
- Изображение или видео генерируется в фоне, и скрипт должен дождаться готового файла.
Не подходит, если
- Нужен готовый MCP-сервер: для него есть отдельный репозиторий ElevenLabs.
- Ключа API ElevenLabs нет: почти все команды ходят в облако.
- Сеть недоступна: из офлайн-команд работают только схемы агентов по локальным файлам.
Пример запроса к агенту
Скачай конфигурации моих агентов командой `elevenlabs agents pull`, нарисуй схему агента Support и покажи, какие инструменты в нем вызываются.Ограничения
Нужен ключ API ElevenLabs в переменной `ELEVENLABS_API_KEY` или файле `.env` в рабочей папке, расход идет по тарифу аккаунта. Метод `agents delete` удаляет агента на платформе, но не трогает локальные файлы. Во второй версии `agents list` показывает облачный список, а локальный статус дает `agents status`. По умолчанию `say` берет самую выразительную модель, а `flash`-модели читают текст без аудиотегов. Каждый запрос несет анонимные метки платформы в `User-Agent`, их отключает `--telemetry off`.
Как отключить. Выполните `npm uninstall -g @elevenlabs/cli` либо `brew uninstall elevenlabs`, затем удалите `~/.elevenlabs/config.json`. Ключ отзовите в настройках ElevenLabs.
Частые вопросы
Как поставить CLI?
Через Homebrew (`brew install elevenlabs/tap/elevenlabs`), Scoop, npm (`npm install -g @elevenlabs/cli`), скрипт установки или сборкой из исходников на Rust. Разовый запуск без установки: `npx @elevenlabs/cli <команда>`.
Как передать ключ API?
Переменной `ELEVENLABS_API_KEY`, файлом `.env` в рабочей папке или разово флагом `--xi-api-key`. Ключ ограничивают одним проектом через `.env`.
Что делает `agents push`?
Выкладывает локальные конфигурации на платформу, перезаписывая основную и зарегистрированные ветки. Флаг `--dry-run` показывает изменения без отправки.
Как сказать вслух, что сборка готова?
Командой `elevenlabs say "сборка завершена"` или через `echo "готово" | elevenlabs say`. Голос и модель задает `elevenlabs say config`.
Что такое `--intent`?
Необязательный флаг: агент одной фразой объясняет, зачем запускает команду. Текст уходит в заголовок `X-Agent-Intent` и помогает вендору понять сценарии.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыДесять скиллов от ElevenLabs: озвучка текста, расшифровка, голосовые агенты, звуковые эффекты, музыка, дубляж и очистка голоса через API
MCP-сервер озвучки: превращает текст и сценарии с несколькими голосами в аудио через ElevenLabs и хранит историю заданий.
Локальный синтез речи для агентов: команда и скилл озвучивают текст, клонируют голос по записи и собирают музыку из партитуры без облака и платы за символы
CLI и скилл для Claude Code, Codex и Cursor: индекс видео, поиск по словам и тексту кадра, кадры крупно и замер монтажа
Piper — CLI для локальной озвучки текста: выбирайте голос, сохраняйте WAV и подключайте синтез к своим приложениям.
Консольная утилита polli генерирует текст, изображения, аудио и видео на моделях Pollinations и подключает кодовых агентов.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ElevenLabs CLI (эта карточка) | нет | 104 | ||
| ElevenLabs Skills | да | 559 | десять скиллов ElevenLabs для озвучки, расшифровки и агентов; здесь бинарный CLI на весь API и управление агентами через Git | |
| ElevenLabs MCP Server | нет | API-ключ | 119 | MCP-сервер озвучки с историей заданий; CLI работает без MCP, из оболочки и CI |
Коротко о README
Это единый бинарный файл на Rust с двумя ролями: полный доступ к API и рабочий процесс «агенты как код». Для CI есть режимы без ключа, а команды Flows умеют работать через вебхуки.