Sferum Bot от @xKARASb

This README is also available on English <- click.

Работает на

• Python 3.13+

Использованные технологии:

• Asyncio
• Aiogram 3.x

Возможности:

• Пересылать текстовые сообщения в telegram.
• Пересылать медиа в telegram (ограничиваясь лимитами telegram).
• Можно получать сообщения из нескольких чатов.
• Отправка пересланных сообщений с медиа.
• Поддержка каналов.

Как пользоваться?

1. Клонируем репозиторий:

git clone https://github.com/xKARASb/SferumBot.git
cd SferumBot

2. Заполняем поля в .env.dist:

• AUTH_COOKIE

Инструкция для Microsoft Edge

Зайдите в Sferum.

Нажмите Ctrl + Shift + C, после чего откроются параметры для разработчиков.

Перейдите в раздел Application (Приложение) >> Storage (Хранилище) >> Cookies (Файлы cookie) >> https://web.vk.me.

Затем введите в поле поиска "remixdsid" и скопируйте его значение (должно начинаться с "vk1.a.").

Заполните поле в .env.dist.

• BOT_TOKEN

Перейдите в @BotFather.

Введите команду /newbot, а затем укажите название и юзернейм для бота (отдельными сообщениями).

Скопируйте токен и вставьте его в .env.dist.

• TG_USER_ID

Вы можете получить ваш id в этом боте.

Скопируйте его и вставьте его в .env.dist.

• TG_CHAT_ID

Можно оставить пустым, если не собираетесь использовать бота в группе/канале.

В настройках телеграм включите отображения id: Настройки > Продвинутые настройки > Эксперементальные настройки > Show Peer IDs in profile.

Запи

ВАЖНО

Дайте боту права администратора в группе/канале.

ЗАМЕТКА

Чтобы пересылать сообщения в один из разделов супергруппы вы можете указать его id в TG_TOPIC_ID.

• VK_CHAT_ID

Получите id чата, открыв его в браузере:

https://web.vk.me/convo/{здесь нужный нам id}

Вы можете записать чаты, из которых необходимо пересылать сообщения в .env.dist следующим образом:

VK_CHAT_ID=200000015, 200000016
VK_CHAT_ID=200000015,200000016
VK_CHAT_ID=200000015

3. Переименуйте .env.dist -> .env.

4. Установка зависимостей и запуск:

Через uv (рекомендуется)

Устанавливаем uv (если еще не установлен):

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Запускаем:

uv run startup.py

Через requirements.txt

1. Созаём и активируем виртуальное окружение:

python3 -m venv venv
. venv/bin/activate

ЗАМЕТКА

Вторая команда для Windows выглядит следющим образом:

.\venv\Scripts\Activate

2. Установка необходимых пакетов:

pip install -r requirements.txt

3. Запуск:

python3 startup.py

Обращение

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

Если вы хотите использовать бота, но у вас нет сервера или устройства, на котором можно 24/7 запустить программу, можете написать мне в телеграмм, могу захостить на своём сервере за небольшую плату.

Если у вас есть какие-то пожелания или вы нашли проблему, пишите её в issues, так же можете мне написать в телеграмм.

Вы можете поддержать проект любой суммой, я буду очень рад:

Тинькофф 2200701344983280

Сбер 4817760241976004

Получатель Колос М.

Лицензия:

MIT

Открытое програмное обеспечение, черт возьми!