Taro

Taro – Telegram - бот, генерирующий карту дня, объясняющий значения карт таро для различных сфер, делает расклад на картах таро на любой вопрос, имеются модули: загадай карту, да/нет, обмен энергией. Для привлечения внимания к боту используются призывы и послания Вселенной.

Порядок установки и использования

1. Загрузить репозиторий. Распаковать.

2. Установить Python версии 3.11 и выше. Рекомендуется добавить в PATH.

3. Открыть каталог со скриптом в консоли: можно воспользоваться командой cd или встроенными возможностями файлового менеджера.

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

python -m venv .venv

5. Активировать вирутальное окружение.

Для Windows.

.venv\Scripts\activate.bat

Для Linux или MacOS.

source .venv/bin/activate

6. Установить зависимости скрипта.

pip install -r requirements.txt

7. Настроить бота путём редактирования Settings.json.

Settings.json.

"token": ""

Токен бота Telegram (можно получить у BotFather).

"qr_image": ""

Путь к изображению, который отправляется по команде /share.

"start_animation": ""

Путь к анимации, которая отправляется по команде /start.

"chat_id": null

ID пользователя, для формирования кэша изображения описанного выше (смотреть подробнее TeleCache). Для получения ID пользователя можно воспользоваться ботом.

"subscription_chanel": null

ID канала, на который должен быть подписан пользователь, для работы с ботом. Для получения ID канала можно воспользоваться ботом.

"subscription_link": ""

Ссылка на канал, на который должен быть подписан пользователь, для работы с ботом.

"password": ""

Пароль для вызова административной панели при вызове /admin {password}.

"language": ""

Код, используемого ботом языка. По умолчанию поддерживаются: ru. Локализация осуществляется через GNU gettext.

"letters": ""

Путь к файлу excel, используемый для посланий и призывов.

Колонки:

1. Послания
2. Призывы

"yes_no": ""

Путь к файлу excel, используемый для модуля да/нет.

Колонки:

1. Обычные карты (название карты)

2. Значения обычных карт

3. Перевернутые карты (название перевёрнутой карты)

4. Значения перевернутых карт

"motto_day": ""

Путь к файлу excel, используемый для для девизов дня.

Колонка:

1. Девизы

"online_layout": ""

Путь к файлу excel, используемый для для общих и любовных вопросов в онлайн раскладе.

Колонка:

1. Общие вопросы:

2. Про любовь:

3. Добавить материалы, используемые в боте в папку Materials, со структурой показанной ниже.

Структура файлов

.
└── Materials
├── ChoiceCard
│ ├── 02.06.2025 # понедельник
│ │ ├── 0.txt
│ │ ├── 0.jpg
│ │ ├── 1.txt
│ │ ├── 1.jpg
│ │ ├── 2.txt
│ │ ├── 2.jpg
│ │ ├── 3.txt
│ │ ├── 3.jpg
│ │ ├── 4.txt
│ │ └── 4.jpg
│ ├── 04.06.2025 # среда
│ ├── 06.06.2025 # пятница
│ └── ...
├── Layouts/
│ ├── 1 комплект/
│ │ ├── 1.jpg <!-- Изображение трёх закрытых карт, далее карты поочерёдно открываются в следующих изображениях -->
│ │ ├── ...
│ │ ├── 4.jpg
│ │ └── cards.json <!-- Список из названий карт, использующихся в этом комплекте -->
│ ├── 2 комплект
│ └── ...
├── Photo /
│ ├── 18.01.2025.jpg <!-- Карта дня -->
│ ├── 19.01.2025.jpg
│ └── ...
├── Reversed
│ ├── 1.jpg
│ ├── ...
│ ├── 78.jpg
│ └── ...
├── Straight
│ ├── 1.jpg
│ ├── ...
│ └── 78.jpg
├── Text /
│ ├── 18.01.2025.txt <!-- Текст карты дня -->
│ ├── 19.01.2025.txt
│ └── ...
├── Values/
│ ├── Arcanas/
│ │ ├── 0. Шут/
| │ │ ├── 1.txt <!--Текст общее значение для карты шута -->
| │ │ ├── 2.txt <!--Текст личностное состояние для карты шута -->
| │ │ ├── 3.txt <!--Текст на глубоком уровне для карты шута -->
| │ │ ├── 4.txt <!--Текст в работе и карьере для карты шута -->
| │ │ ├── 5.txt <!--Текст в финансах для карты шута -->
| │ │ ├── 6.txt <!--Текст в любовной сфере для карты шута -->
| │ │ ├── 7.txt <!--Текст состояние здоровья для карты шута -->
| │ │ ├── 8.txt <!--Текст перевернутая карта для карты шута -->
| │ │ └── image.jpg <!-- Карта шута -->
| │ ├── I. Маг/
| │ │ └── ...
| │ ├── II. Жрица
| │ ├── III. Императрица
| │ ├── IV. Император
| │ ├── IX. Отшельник
| │ ├── V. Жрец
| │ ├── VI. Влюбленные
| │ ├── VII. Колесница
| │ ├── VIII. Справедливость
| │ ├── X. Фортуна
| │ ├── XI. Сила
| │ ├── XII. Повешенный|
| │ ├── XIII. Смерть
| │ ├── XIV. Умеренность
| │ ├── XIX. Солнце
| │ ├── XV. Дьявол
| │ ├── XVI. Башня
| │ ├── XVII. Звезда
| │ ├── XVIII. Луна
| │ ├── XX. Суд
| │ └── XXI. Мир
| ├── Cups/
| │ ├── 1. Туз кубков/
| │ │ ├── 1.txt
| │ │ ├── ...
| │ │ ├── 8.txt
| │ │ └── image.jpg
| │ ├── 2. Двойка кубков/
| │ │ └── ...
| │ ├── ...
| │ ├── 10. Десятка кубков
| │ ├── 11. Паж кубков
| │ ├── 12. Рыцарь кубков
| │ ├── 13. Королева кубков
| │ └── 14. Король кубков
| ├── Pentacles/
| │ ├── 1. Туз пентаклей/
| │ │ ├── 1.txt
| │ │ ├── ...
| │ │ ├── 8.txt
| │ │ └── image.jpg
| │ ├── 2. Двойка пентаклей/
| │ │ └── ...
| │ ├── ...
| │ ├── 10. Десятка пентаклей
| │ ├── ...
| │ └── 14. Король пентаклей
| ├── Swords/
| │ ├── 1. Туз мечей/
| │ │ ├── 1.txt
| │ │ ├── ...
| │ │ ├── 8.txt
| │ │ └── image.jpg
| │ ├── 2. Двойка мечей/
| │ │ └── ...
| │ ├── ...
| │ ├── 10. Десятка мечей
| │ ├── ...
| │ └── 14. Король мечей
| └── Wands/
| ├── 1. Туз жезлов/
| │ ├── 1.txt
| │ ├── ...
| │ ├── 8.txt
| │ └── image.jpg
| ├── 2. Двойка жезлов/
| │ └── ...
| ├── ...
| ├── 10. Десятка жезлов
| ├── ...
| └── 14. Король жезлов
└── Video
├── 03.06.2025.mp4
├── 04.06.2025.mp4 └── ...

9. Для удобства работы с ботом рекомендуется добавить список команд в настройках бота в BotFather.

start - start working.

mailset - setting up the distribution of the map of the day.

share - share bot with friends.

10. Запустить файл main.py.

python main.py

11. Для автоматического запуска рекомендуется провести инициализацию сервиса через systemd на Linux или путём добавления его в автозагрузку на Windows.

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

---

Copyright © Dub Irina. 2024-2025.