Skip to content

Kidpun/kidhik

Repository files navigation

KidHik

KidHik Userbot

Мощный Telegram userbot с 40+ командами

Python Telethon License: MIT Deploy: Server

⚠️ Предназначен для запуска только на сервере (VPS/Linux). Локальный запуск не рекомендуется.


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

📋 Все команды (нажми, чтобы раскрыть)

🛠 Утилиты

Команда Описание
.помощь Список всех команд
.пинг Пинг до серверов Telegram
.whoami Информация о себе
.calc <выражение> Калькулятор: .calc 2^10 + 5*3
.напомни <время> <текст> Напоминание: .напомни 10м позвонить
.tr <текст> Перевод текста
.тайп <текст> Эффект печатания
.стоп Остановить активные задачи

👤 OSINT / Профили

Команда Описание
.инфо @user Информация о пользователе
.id @user Получить Telegram ID
.пробив @user Пробив через OSINT
.история @user История изменений профиля
.юзернейм_история @user История юзернеймов
.фото_история @user История фото профиля
.связи @user Связанные аккаунты
.слежка @user Слежка за пользователем

🌐 Сеть

Команда Описание
.ip <ip> Информация об IP
.домен <домен> Данные о домене
.whois <домен> WHOIS запрос
.поиск_номер <номер> Поиск по номеру телефона

🎵 Медиа

Команда Описание
.музыка Поиск музыки через Spotify
.шазам Распознавание аудио/голосовых
.dl <ссылка> Скачивание видео/аудио
.круг Конвертировать видео в кружок

🎲 Развлечения

Команда Описание
.цитата Цитата дня
.факт Случайный факт
.монетка Подбросить монетку
.статья Случайная статья Wikipedia
.бреинрот Brainrot генератор
.процент <вопрос> Шанс в процентах

🤖 Авто-функции

Команда Описание
.откат Авто-ответ на "откат" в чатах
.троль Режим троллинга
.снос Снос спамеров
.реакции Авто-реакции
.чек Ловец чеков
.игнор @user Игнорировать пользователя
.статистика Статистика бота

🧰 Стек технологий

Технология Назначение
Python Python 3.10+ Основной язык
Telegram Telethon MTProto Telegram API клиент
Spotify Spotify API Поиск и воспроизведение музыки
Yandex Yandex Music Альтернативный источник музыки
Google Gemini AI AI-ответы и DDG поиск
SQLite Локальная база данных
python-dotenv Управление конфигурацией

⚙️ Установка на сервер (VPS/Linux)

1. Клонировать репозиторий

git clone https://github.com/Kidpun/kidhik.git
cd kidhik

2. Создать виртуальное окружение

python3 -m venv venv
source venv/bin/activate

3. Установить зависимости

pip install -r requirements.txt

4. Настроить конфиг

cp .env.example .env
nano .env

Заполнить обязательные поля:

Переменная Где взять
API_ID / API_HASH my.telegram.org/apps
BOT_TOKEN @BotFather
SPOTIFY_CLIENT_ID/SECRET developer.spotify.com
GEMINI_API_KEY aistudio.google.com

5. Запустить

python main.py

При первом запуске введи номер телефона и код подтверждения.


🖥 Запуск как systemd-сервис (рекомендуется для сервера)

sudo nano /etc/systemd/system/kidhik.service
[Unit]
Description=KidHik Userbot
After=network.target

[Service]
Type=simple
User=YOUR_USER
WorkingDirectory=/path/to/kidhik
ExecStart=/path/to/kidhik/venv/bin/python main.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
sudo systemctl enable kidhik
sudo systemctl start kidhik
sudo systemctl status kidhik

🌐 Прокси (опционально)

Добавь в .env:

# SOCKS5
PROXY_URL=socks5://user:password@host:port

# HTTP
PROXY_URL=http://1.2.3.4:8080

🔒 Безопасность

  • 🚫 .env никогда не попадает в git — он в .gitignore
  • 🚫 *.session файлы тоже игнорируются
  • OWNER_ID защищает все команды от чужих
  • ✅ При подозрительной активности Telegram удалит сессию — бот уведомит тебя

📁 Структура проекта

kidhik/
├── main.py                 # Точка входа
├── config/
│   └── settings.py         # Все настройки из .env
├── commands/               # 40+ команд userbot
│   ├── calc.py             # Калькулятор
│   ├── remind.py           # Напоминания
│   ├── music.py            # Spotify + Yandex
│   ├── probiv.py           # OSINT
│   ├── network.py          # IP/WHOIS/домены
│   └── ...
├── handlers/               # Обработчики событий Telethon
├── utils/
│   ├── proxy.py            # Система прокси
│   ├── instance_manager.py # Менеджер сессий
│   ├── spotify.py          # Spotify OAuth
│   ├── yandex_music.py     # Yandex Music API
│   └── ...
├── data/                   # Runtime данные (gitignored)
├── text/                   # Текстовые базы (факты, brainrot и т.д.)
├── .env.example            # Шаблон конфига
└── requirements.txt

📄 Лицензия

MIT — делай что хочешь, но звёздочку поставь ⭐


Made with ❤️ by Kidpun

About

🤖 Мощный Telegram userbot с 40+ командами — OSINT, музыка, сеть, авто-функции

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages