MeraveliИзбавляем от рутины с помощью ИИЗаписаться

Для этого маршрута нужны свой Telegram-бот, токен и отдельно оплачиваемый OpenAI API. Секреты вводите только в локальную форму.

Бот · 3

Запасной вариант: ручная установка для Mac и Windows

Этот раздел нужен только если помощник не смог выполнить установку. Основной маршрут — дать ему задание из шага 3 и дождаться проверки. Если помощник уже успешно установил зависимости, повторять установку не нужно. Понадобятся Python 3.11/3.12, Node.js 22/24 LTS, обычный Google Chrome, интернет и минимум 10 GiB свободного резерва плюс место для материалов.

  • Python: выберите подходящую версию и установщик для ОС. На Windows включите Python launcher и добавление Python в PATH, если эти пункты есть в установщике.
  • Node.js: установите 22 или 24 LTS; npm входит в обычную установку.
  • Google Chrome: установите обычный браузер.
  • Дополнительно для аудио/видео, позже: FFmpeg: официальный сайт ссылается на сборки для разных ОС. На Windows распакуйте сборку и добавьте её папку bin, содержащую ffmpeg.exe и ffprobe.exe, в пользовательский PATH. На Mac можно использовать уже установленный проверенный пакетный менеджер.

PATH — список папок, где система ищет программы по короткому имени. На Windows: найдите «Изменение переменных среды для вашей учётной записи» → выберите пользовательский Path → «Изменить» → «Создать» → вставьте путь к папке bin. Не удаляйте старые строки. После установки и изменения PATH закройте терминал и откройте новый. Для начала нужен только текстовый маршрут; проверка FFmpeg ниже пригодится позже.

На Mac: откройте «Терминал» через поиск Spotlight. Если Homebrew уже установлен, FFmpeg можно установить командой brew install ffmpeg. Если Homebrew отсутствует, не запускайте эту команду: используйте официальный вариант установки или попросите Codex объяснить конкретную установку. На Windows: откройте распакованную папку в Проводнике, в адресной строке напишите powershell и нажмите Enter. Это открывает команды сразу в нужной папке.

Mac · Терминал

python3 --version
node --version
npm --version
ffmpeg -version
ffprobe -version

Windows · PowerShell

py -3 --version
node --version
npm.cmd --version
ffmpeg -version
ffprobe -version

Если Python, Node.js или npm «не найдены», основная установка ещё не закончена. Для первого текстового примера FFmpeg и ffprobe не обязательны: их отсутствие не блокирует текст и PNG. Для аудио/видео добавьте их отдельным этапом ниже. При нескольких Python выберите 3.11/3.12; например, используйте python3.12 на Mac или py -3.12 на Windows вместо общей команды. После создания окружения дальнейшие команды используют его собственный Python.

Mac · Терминал

cd "$HOME/carousel-bot"
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
npm install
.venv/bin/python -m carousel_bot.doctor
.venv/bin/python -m unittest discover -s tests
.venv/bin/python -m carousel_bot.export_demo

Windows · PowerShell

py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
npm.cmd install
.\.venv\Scripts\python.exe -m carousel_bot.doctor
.\.venv\Scripts\python.exe -m unittest discover -s tests
.\.venv\Scripts\python.exe -m carousel_bot.export_demo

В Mac-команде путь $HOME/carousel-bot подходит только если папка действительно там. Для другой папки напечатайте cd с пробелом, перетащите папку из Finder в Терминал и нажмите Enter. Команды выполняйте последовательно; при ошибке остановитесь. .venv — отдельная среда Python внутри проекта. npm install устанавливает зависимости оформления, включая Playwright; отдельно скачивать браузер Playwright не нужно, пакет использует установленный Chrome. На Windows npm.cmd помогает обойти запрет запуска npm.ps1 без изменения системной политики.

Бот · 5

Создайте своего бота через BotFather

Установите Telegram с официальной страницы или используйте уже установленное приложение. Войдите в свой аккаунт. В поиске найдите @BotFather и убедитесь, что имя пользователя именно BotFather; не передавайте токен похожим аккаунтам.

Реальная страница загрузки Telegram
1 — Windows x64. 2 — Mac. Выберите только кнопку своей системы. На этом снимке нижняя кнопка Windows относится к другой сборке; для обычного современного Windows используйте верхнюю Windows x64.
Карточка официального BotFather, кнопка START BOT внизу
Нажмите START BOT («Начать»). Стрелка показывает кнопку на этом снимке; в вашем приложении расположение может отличаться.
  1. Нажмите «Начать», затем отправьте /newbot.
  2. Введите обычное название, например «Мои карусели».
  3. Введите уникальное имя пользователя латиницей с окончанием bot, например my_carousel_school_bot. Пример может быть занят: придумайте своё имя.
  4. BotFather выдаст токен — длинную секретную строку. Скопируйте её для локальной формы следующего шага. Не вставляйте токен в чат Codex, письмо, скриншот или публичный документ.
  5. Сохраните ссылку на созданного бота: позже открывать нужно именно его, а не BotFather.

Токен позволяет управлять ботом. При утечке перевыпустите его в BotFather и замените безопасным локальным способом; не пробуйте «спрятать» уже опубликованный токен удалением сообщения. Официальное описание: получение токена бота.

Бот · 6

Настройте API: оплата отдельно от ChatGPT

Telegram принимает сообщения, а OpenAI API в этом учебном боте выполняет оплачиваемую обработку. Войдите в собственную учётную запись OpenAI Platform, проверьте настройки оплаты и создайте собственный ключ на странице API keys. Доступность способов оплаты зависит от аккаунта и региона.

Реальная официальная страница OpenAI API Quickstart с кнопкой создания ключа
1 — Create an API Key («Создать API-ключ»). Эта кнопка открывает кабинет OpenAI. Далее войдите самостоятельно, выберите создание нового секретного ключа и скопируйте его только в локальную форму из шага 8. Не нажимайте Install the plugin: для этого учебного комплекта он не нужен. Оплату и вход выполняет владелец аккаунта.
Подписка ChatGPT и оплата OpenAI API — разные системы. Наличие оплаченного ChatGPT/Codex само по себе не оплачивает запросы этого бота. Официальное пояснение OpenAI.

Точную стоимость нельзя вывести только из числа каруселей: учитываются модели, входной и выходной текст, изображения и длительность аудио. Смотрите актуальные цены и фактическое использование. Ограничение 20 попыток в сутки не является денежным потолком. Настройки бюджета платформы не следует считать гарантией жёсткой остановки всех расходов без проверки их поведения.

Не хотите подключать оплату — продолжайте бесплатный локальный экспорт или вернитесь к шести шагам через Codex в начале страницы. Учебный бот не содержит установленную бесплатную локальную модель ИИ. API-ключ вводят только в локальную форму, а не в команду терминала.

Бот · 7

Введите секреты в локальную форму

Вернитесь в терминал той же папки. Запустите помощник настройки своей ОС:

Mac · Терминал

.venv/bin/python -m carousel_bot.setup_server --open

Windows · PowerShell

.\.venv\Scripts\python.exe -m carousel_bot.setup_server --open
Реальная локальная форма с пустыми полями Telegram и OpenAI API
Реальный снимок формы, секреты не введены. 1 — поле токена BotFather. 2 — поле OpenAI API-ключа. 3 — кнопка сохранения. Вводите значения только в форму на своём компьютере.

Браузер должен открыть http://127.0.0.1:8769. 127.0.0.1 означает этот компьютер. Проверьте адрес перед вводом: не посторонний сайт и не форма из Telegram. Если браузер не открылся автоматически, откройте этот адрес вручную, пока команда работает.

  1. Вставьте токен BotFather в поле Telegram.
  2. Вставьте свой OpenAI API-ключ в соответствующее поле.
  3. Сохраните. Форма записывает значения в локальные исключённые из Git файлы .secrets/telegram.env и .secrets/openai.env, не показывает их обратно и не проверяет ключи через внешнюю сеть.
  4. Скопируйте показанную команду /start КОД целиком и сохраните временно для следующего шага. КОД — индивидуальный код привязки, а не буквальное слово «КОД». Он тоже приватный.

После сохранения помощник останавливается. Исчезновение доступности страницы затем нормально. Форма не запускает бота: запуск отдельно в следующем шаге. Если закрыли форму до копирования команды, попросите Codex безопасно повторно выдать локальную команду привязки без чтения ключей в чат. Не удаляйте .secrets ради нового запуска формы: повторное сохранение поверх существующих ключей специально запрещено.

На Windows храните проект в личной папке профиля и не открывайте к нему доступ другим пользователям: правила chmod из Mac не заменяют права доступа Windows.

Бот · 8

Запустите бота и привяжите свой Telegram

Mac · Терминал

.venv/bin/python -m carousel_bot.bot

Windows · PowerShell

.\.venv\Scripts\python.exe -m carousel_bot.bot
  1. Оставьте терминал открытым. Пока бот работает, команда не возвращается к обычному приглашению ввода — это нормально.
  2. Откройте своего нового бота по ссылке от BotFather.
  3. Отправьте ему команду /start КОД из локальной формы. Простой /start не заменяет приватный код.
  4. Дождитесь подтверждения привязки. Затем отправьте /help и прочитайте ответ.

Если бот молчит, сначала проверьте запущенную команду, интернет и сообщение ошибки в терминале. Не показывайте ключи и не запускайте второй экземпляр: комплект блокирует двойной процесс. Успех /help подтверждает связь и привязку, но ещё не генерацию карусели.

Остановка, повторный запуск и сон компьютера

Чтобы остановить бота, выберите его терминал и нажмите Ctrl+C (на Mac именно Control, не Command). Для повторного запуска выполните ту же команду; заново вводить ключи и привязываться обычно не нужно. Можно использовать комплектные ярлыки start.command/setup.command на Mac и start.cmd/setup.cmd на Windows после создания .venv.

Бот отвечает, пока процесс работает, компьютер включён, подключён к интернету и не спит. Закрытие крышки ноутбука, сон и завершение терминала могут остановить ответы. На Mac при необходимости временно предотвращайте сон штатными настройками или caffeinate; это не гарантирует работу при закрытой крышке. На Windows настройте сон при питании от сети на время занятия, затем восстановите обычный режим. Это локальный помощник, а не круглосуточный сервер.

Бот · 9

Первый платный запрос: начните с короткого текста

Не начинайте с длинного видео. Сначала отправьте своему боту короткий самостоятельный текст:

Сделай полезную карусель для начинающего фотографа.
Тема: как подготовиться к первой прогулочной фотосессии.
Цель: читатель собирает вещи и согласует съёмку заранее.
Материал: выбери место и запасной вариант на случай дождя; проверь заряд аккумулятора; возьми воду; заранее договорись о времени и длительности.
Не добавляй неподтверждённые цифры и обещания результата.

Получение текста ботом ещё не должно считаться выполненной генерацией. Нажмите «Подготовить»: этот шаг запускает оплачиваемую обработку. Выполняйте его, только если готовы оплатить запросы своего API-аккаунта. Дождитесь результата, не создавая одинаковые задания подряд.

Учебный пакет выдаёт 6–8 PNG и подпись. Авторская дополнительная карточка в комплекте отключена. Для длинных записей сначала выбираются темы; первая карусель строится автоматически. /topics показывает остальные темы. Сначала оцените одну короткую карусель и расходы, затем переходите к большим материалам.

Дополнительный этап — аудио и видео. Сначала попросите Codex: «Установи или найди FFmpeg и ffprobe для моей ОС, проверь обе команды и запусти doctor --video. Не запускай платный API. Не меняй другие проекты». При ошибках не отправляйте видео до исправления. После успешной проверки поддерживаются короткий текст, TXT/MD в UTF-8, изображения JPG/PNG/WebP, аудио MP3/M4A/WAV/OGG и видео MP4/MOV/WebM до 20 МБ на файл. UTF-8 — кодировка текста, сохраняющая русские буквы. Ссылки YouTube/Reels/TikTok учебный пакет не скачивает: отправляйте файл. Большой файл сначала сокращайте с сохранением оригинала. Дополнительный локальный Telegram Bot API здесь не установлен.

Если произошла ошибка

Не нажимайте «Подготовить» много раз подряд. Проверьте сообщение бота, интернет и оплату. Оплачиваемый запрос мог списать средства даже при сетевой ошибке. /retry после ошибки требует отдельного подтверждения; это новый платный риск. Получить уже созданный результат повторно можно без новой генерации. В usage.json сохраняются данные использования; сверяйте их также с кабинетом API.

Бот · 10

Проверьте PNG, подпись и загрузите вручную

Сохраните полученные изображения из Telegram без изменения порядка. Откройте все слайды, а не только обложку. Подпись скопируйте из ответа бота или caption.txt в папке результата. Факт выдачи файлов не означает, что материал уже опубликован или принят по качеству.

  • Тема понятна на первом слайде; обещание обложки раскрыто дальше.
  • Имена, числа, цитаты и инструкции верны; неизвестное удалено или проверено.
  • В каждом слайде один вывод с примером/действием, нет пустой интриги.
  • Русские буквы, переносы и края текста правильные; всё читается на телефоне без увеличения.
  • Порядок картинок соответствует смыслу; подпись не обещает несуществующий материал.

В Instagram создайте новую публикацию, выберите несколько изображений в правильном порядке, проверьте обрезку каждого и вставьте подпись. Названия кнопок могут меняться. Перед отправкой ещё раз проверьте предварительный просмотр. После публикации откройте запись и перелистайте все слайды. Instagram-пароль боту не нужен; автоматической публикации в комплекте нет.

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

Бот · 11

Ручной экспорт без оплаты API

Если вы сами подготовили сценарий, бот и ключи не нужны. Откройте examples/demo.json как образец и создайте свою копию, например examples/my-carousel.json. Не меняйте обязательные имена полей. JSON — строгий текстовый формат: ошибочная запятая или кавычка мешает чтению.

Прочитай README.md и examples/demo.json. На основе моего утверждённого текста создай examples/my-carousel.json, сохранив схему title, caption, notes, images, slides. Нужно 6–8 слайдов с полями eyebrow/title/body/image_index. Для слайдов без фото используй image_index=-1. Не выдумывай факты. Не запускай бот, сообщения или API. Проверь JSON и локально экспортируй в новую папку output/my-carousel. Проверь PNG 1080×1350 и переполнение, покажи файлы и короткий отчёт.

Mac · Терминал

.venv/bin/python -m carousel_bot.export_demo --source examples/my-carousel.json --out output/my-carousel

Windows · PowerShell

.\.venv\Scripts\python.exe -m carousel_bot.export_demo --source examples/my-carousel.json --out output/my-carousel

Для каждого нового экспорта выбирайте новую пустую папку результата, например output/my-carousel-v2. Комплект останавливает экспорт в непустую папку, чтобы не смешивать версии и не оставлять старые слайды. Если экспорт остановлен из-за переполнения, сначала сократите текст или измените переносы с сохранением смысла. Не уменьшайте всё до нечитаемого шрифта. Такой экспорт бесплатен по API, но написание сценария в стороннем чате зависит от условий того сервиса.

Помощь

Если что-то не работает

Команда не найдена / неверная папка

Откройте новый терминал после установки. Проверьте версии программ и наличие README в текущей папке. Не копируйте команду cd для чужого расположения. На Windows попробуйте штатный launcher py; если его нет, сначала проверьте python --version. Не меняйте системную политику ради npm.ps1 — используйте npm.cmd.

Chrome или FFmpeg не обнаружены

Проверьте обычную установку Chrome. Для нестандартного расположения попросите Codex безопасно задать CAROUSEL_CHROME с фактическим путём. ffmpeg и ffprobe должны оба находиться через PATH. Перезапуск терминала обязателен после его изменения. Не вводите случайные пути из чужой инструкции.

Локальная форма не открывается

Убедитесь, что setup_server работает и не завершился с ошибкой. Откройте 127.0.0.1:8769 вручную. После успешного сохранения форма закрывается — это ожидаемо. Если порт занят, сначала найдите процесс и его назначение; не завершайте неизвестную программу вслепую. Не переносите форму на публичный адрес.

Бот молчит или обработка остановилась

Проверьте процесс, интернет, сон компьютера и точность команды привязки. При ошибке API сверяйте оплату и лимиты; многократный retry может увеличить расходы. Если нужно сообщить ошибку Codex, передавайте короткий текст без токена, ключа, приватной команды /start и содержимого секретных файлов.

Что в этой инструкции уже проверено

README относится к новому чистому учебному комплекту. technical-audit.md описывает более раннюю проверку авторского проекта: замечания о запуске бота из формы, отсутствии поля API и несовместимости Windows относятся к прежней версии. Здесь используются команды нового README: форма хранит оба секрета и не запускает бот. Mac проверен локально, Windows остаётся без реального испытания на ПК. Проверки конкретного ученика и первый оплачиваемый результат — отдельные необходимые этапы.

Проверка

Официальные источники и итоговая проверка

Если вы выбрали путь без Telegram: сценарий проверен → все PNG созданы и просмотрены → картинки лежат в одной папке с подписью → вы одобрили комплект. Создавать бота и вводить API-ключ для этого пути не нужно.

Если вы выбрали Telegram-бота: бесплатный пример работает → бот отвечает вам после привязки → вы осознанно запустили платную обработку → получили и проверили все картинки и подпись.

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

Карусель — только начало

Так же ИИ может взять на себя отчёты, сметы и однотипные письма. На воркшопе за 3 часа соберём мини-сервис под вашу задачу

Ближайшие даты и цены — на странице воркшопа.

Посмотреть воркшоп