🛡️ Кибер Гид — Telegram-бот

Кибер Гид — это Telegram-бот, созданный как интерактивный помощник по кибербезопасности.
Он помогает пользователям распознавать мошеннические сообщения, консультирует по вопросам цифровой безопасности и даёт простые инструкции для защиты данных.

---

⚙️ Возможности бота

• 🧑‍💻 Консультант — отвечает на вопросы о кибербезопасности простым языком с пошаговыми рекомендациями.
• 🔍 Проверка сообщений — анализирует тексты (SMS, e-mail, чаты) и выдает вердикт:
  ✅ Безопасно / ⚠️ Подозрительно / ⛔ Опасно / ⚪ Недостаточно данных.
• 📋 Инструкции — краткие памятки по основным темам:
  • 🚀 Быстрый старт (5 обязательных шагов для защиты)
  • 🎣 Фишинг: как распознать
  • 📞 Коды и звонки «из банка»
  • 🔑 Двухфакторная аутентификация (2FA)
  • 🔒 Пароли и менеджеры паролей
  • ⚠️ Действия при взломе аккаунта
  • 💾 Резервные копии (правило 3-2-1)

🚀 Установка и запуск

1. Скачайте и распакуйте файлы проекта, откройте папку в VsCode.

Или используйте консоль для клонирования репозитория:

git clone https://github.com/kuvl/CyberGidBot.git
cd CyberGidBot

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

Виртуальное окружение помогает изолировать зависимости проекта.

python -m venv venv

Активация:

• На Windows:

  venv\Scripts\activate

• На macOS/Linux:

  source venv/bin/activate

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

Можно сразу установить галочку на файле requirements.txt при создании виртуального окружения в VsCode.
Или установите все необходимые библиотеки через терминал:

pip install -r requirements.txt

4. Настройка переменных окружения

Создайте файл .env в корневой папке проекта и добавьте туда ваши ключи:

TELEGRAM_BOT_TOKEN=ваш_токен_бота
YA_API_KEY=ваш_яндекс_api_key
YA_FOLDER_ID=ваш_каталог_яндекс_консоли  

• TELEGRAM_BOT_TOKEN — получите в @BotFather в Telegram.
• YA_API_KEY — получите на сервисе, который используется для ИИ (например, YandexGPT).
• YA_FOLDER_ID - скопируйте из яндекс консоли.

5. Запуск бота

Запустите бота командой:

python bot.py

Если всё настроено верно, бот начнет работать и принимать сообщения в Telegram.

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

• CyberGidBot/
• ├── bot.py # Логика Telegram-бота
• ├── model.py # Работа с нейросетью
• ├── prompts/ # Системные инструкции для режимов
• │ ├── prompt_consultant.txt
• │ └── prompt_check.txt
• ├── requirements.txt # Зависимости
• ├── .env.example # Пример файла с ключами
• └── README.md # Документация

📝 Примечания

• Режимы переключаются кнопками: «🧑‍💻 Консультант» / «🔍 Проверка».

• В режиме проверки ответы строго структурированы (Вердикт → Почему → Что делать).

• Для примеров тестов можно использовать типичные SMS: банковские уведомления, фишинговые ссылки, «код подтверждения» и т. п.