admin/social-post-writer-bot
1
0 Fork 0
Code Issues 7 Pull Requests Actions Packages Projects 2 Releases Wiki Activity
Page: Home
Pages
Deployment Developer Guide Home Subscription Support User Guide
Clone
8
Home
Hermes Agent edited this page 2026-10-11 22:55:17 +02:00
Table of Contents

Social Post Writer Bot

Телеграм-бот для генерации постов для соцсетей. По запросу пользователя готовит три варианта текста, адаптированных под его Tone of Voice.

  • Бот: @post_master_bot
  • Репозиторий: admin/social-post-writer-bot
  • Стек: Python 3.12, aiogram 3.x, aiohttp, SQLite, APInex (LLM / STT / vision)
  • Деплой: Coolify, окружение development, приложение social-post-writer-bot-development
  • Версия разработки: 0.1.0+61

Возможности

Возможность Описание
Генерация постов На явную просьбу или реплай-правку — 3 отдельных варианта сообщениями
Пост без темы «✍️ Придумать пост» / /post — бот сам выбирает тему по обученному профилю аккаунта
Пост по изображению Изображение или галерея с подписью-ТЗ → три варианта поста
Tone of Voice Скриншоты, текст, голос или аудио — бот накапливает сведения об аккаунте и обновляет профиль
Голосовой ввод Голосовые расшифровываются (APInex STT) и работают как текст
Идеи «предложи тему» или /idea — одна идея (заголовок, угол, зачем)
Режимы «Обучение», «Генерация», «Подписка», «Помощь» — нижнее меню с кнопкой возврата
Поддержка «🆘 Поддержка» — переписка с оператором в личке, у него в персональном топике группы
Помощь /help — меню разделов с обычными inline-кнопками; из любой страницы доступны все разделы, включая текущий
Подписка Триал 3 дня, затем 30 дней за 100 звёзд (реальная оплата Telegram Stars)

Быстрый старт

  1. Напиши боту /start — получишь онбординг и пробный период на 3 дня.
  2. Зайди в «Обучение» и пришли скриншоты своих постов или расскажи об аккаунте.
  3. Зайди в «Генерация» и опиши тему: «напиши пост про запуск нового продукта» — получишь три варианта.
  4. Не нравится — ответь реплаем: «сделай короче».
  5. Нет темы? Нажми «✍️ Придумать пост» — бот придумает её сам по профилю аккаунта.

Разделы вики

  • Пользователю — сценарии, команды, подписка
  • Разработчику — архитектура, потоки, функции, БД, логирование
  • Деплой — Coolify, переменные, деплой-скрипт, проверка после деплоя
  • Поддержка — как работает обращение, топики, заметки оператора
  • Подписка — модель, таблица БД, жизненный цикл, Stars

Ключевые файлы репозитория

bot.py            — роутинг, команды, обработка сообщений
payments.py       — оплата Telegram Stars
apinex_client.py  — клиент APInex (LLM, STT, vision)
user_store.py     — SQLite: пользователи, ToV, посты, идеи, API-логи, подписки
raw_updates.py    — dev-only БД сырых входящих Telegram Update
support.py        — поддержка: личка ↔ персональный топик в группе операторов
keyboards.py      — клавиатуры режимов
help_message.py   — Rich Message справка
VERSION           — версия релиза
Dockerfile        — python:3.12-slim
tests/            — юнит-тесты (unittest)

Полная документация — в README.md и IDEA.MD репозитория.

Навигация

Бот: @post_master_bot