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.