Tarot Bot

Телеграм-бот для предсказаний таро, нумерологии и психологической поддержки с реферальной системой и админ-панелью.

Возможности

🔮 Натальная карта по таро

Анализ энергетической картины личности пользователя по дате рождения. Использует древние знания таро для характеристики основных черт характера, жизненной энергии, скрытых талантов и karmic задач.

Как использовать: Укажите дату рождения в формате ДД.ММ.ГГГГ

Результат: Подробное описание личности, советов по развитию и предсказания на основе таро.

🎴 Расклад на 3 карты

Классический таро-расклад на три карты для быстрого ответа на актуальные вопросы. Каждая карта представляет прошлое, настоящее и будущее ситуации.

Как использовать: Задайте вопрос, связанный с любым аспектом жизни

Результат: Мистическое толкование комбинации карт с советами.

🌟 Матрица жизни

Нумерологический анализ судьбы и предназначения по методу Пифагора. Рассчитывает вибрацию дат рождения, циклы жизни и karmic уроки.

Как использовать: Укажите дату рождения в формате ДД.ММ.ГГГГ

Результат: Полная карта жизни с описанием сильных сторон, зон роста и жизненной миссии.

❓ Свободный вопрос

Консультация профессионального психолога через ИИ. Помощь в решении личных проблем, снятии стресса и самоанализе.

Как использовать: Напишите о своих чувствах, проблемах или вопросах

Результат: Поддерживающий разговор, советы и техники самореализации.

ИИ и промпты

Бот использует современную нейросеть LLaMA 3.1 8B Instant через API Groq для генерации ответов. Все промпты тщательно настроены для каждой услуги:

🔮 Натальная карта

Промпт создает образ виртуального астролога, который дает мягкий, мудрый анализ личности. Подчеркивает глубину характера, энергии, сильные и слабые стороны без категоричных предсказаний.

🎴 Расклад на 3 карты

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

🌟 Матрица жизни

ИИ-нумеролог, который рассчитывает вибрации дат и дает глубокий анализ жизненного пути. Фокусируется на karmic уроках, талантах и миссии.

❓ Свободный вопрос

Промпт психолога с профессиональным стилем. Избегает диагнозов, дает практические советы и поддерживает диалог. Использует технику активного слушания.

Технические особенности

• Язык: Все промпты на английском для лучшей точности ИИ
• Длина ответа: Ограничена 1000 токенами, что примерно 600-800 слов
• Перевод: Ответы автоматически переводятся на русский через Google Translator
• Контекст: Для чата поддерживается история последних 10 сообщений
• Скорость: Быстрые ответы благодаря оптимизированному API Groq

📥 Реферальная система

Система привлечения друзей с взаимной выгодой:

• Приглашение: Каждый пользователь может получить уникальную реферальную ссылку
• Бонус: Каждый приглашенный друг дает рефереру +1 запрос в день навсегда
• Ограничение: Ссылка работает только один раз на пользователя

Как использовать: Выберите кнопку "📥 Пригласить друга" для получения ссылки

📝 Жалобы и поддержка

Система обратной связи для пользователей и админов:

• Пользователь: Может отправить жалобу или вопрос о работе бота
• Админ: Просматривает, отвечает и решает проблемы

Как использовать: Кнопка "📝 Подать жалобу"

Админ-панель

Полный контроль над ботом с возможностями:

• 📊 Статистика: Просмотр общего количества пользователей, запросов, рефералов
• 👥 Пользователи: Список активных пользователей, блокировка/разблокировка, поиск по ID
• 📢 Рассылка: Отправка сообщений всем пользователям или активным за неделю
• ⚙️ Настройки: Управление лимитами запросов, редактирование промптов ИИ
• 📋 Отчеты: Анализ нагрузки на API, популярности услуг
• 📝 Жалобы: Обработка обратной связи от пользователей

Доступ: Только для пользователей из списка ADMIN_USERS в коде (команда /admin)

Требования

• Python 3.8+
• API ключи от Groq (LLM)
• Токен Telegram бота

Установка

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

git clone <repository-url>
cd tarot_bot

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

python -m venv venv
source venv/bin/activate  # Для Linux/Mac
# или
venv\Scripts\activate     # Для Windows

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

pip install -r requirements.txt

4. Создайте файл config.py на основе примера:

TELEGRAM_TOKEN = 'ваш_токен_от_telegram'
GROQ_API_KEY = 'ваш_ключ_ot_groq'
DEFAULT_LIMIT = 3
BOT_USERNAME = '@your_bot_username'

Получение ключей API

Telegram Token

1. Обратитесь к @BotFather в Telegram
2. Создайте нового бота командой /newbot
3. Скопируйте токен

Groq API Key

1. Зарегистрируйтесь на Groq
2. Создайте API ключ в разделе API Keys
3. Скопируйте ключ

Запуск

python bot.py

Бот начнет работу в Telegram. Используйте /start для начала.

Админ-права

Чтобы получить доступ к админ-панели, отправьте команду /admin с ID пользователя, указанного в коде (по умолчанию 366323850). Вы можете изменить список админов в переменной ADMIN_USERS.

Особенности

• Лимиты запросов: Каждый пользователь имеет ограниченное количество запросов в день, которое можно увеличить через реферальную систему
• Реферальная система: Приглашайте друзей для получения дополнительных запросов на постоянной основе
• Управление жалобами: Пользователи могут отправлять жалобы, администраторы могут их просматривать и отвечать
• Статистика: Подробная аналитика использования бота

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

• bot.py - основной файл бота
• config.py - конфигурационный файл с токенами
• requirements.txt - зависимости Python
• bot_data.db - база данных SQLite (создается автоматически)

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

• Никогда не коммитите config.py в репозиторий
• Используйте переменные окружения для чувствительных данных в продакшене
• Убедитесь, что админ-права присвоены только доверенным пользователям

Поддержка

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

Лицензия

MIT License