Tarot bot.

Abstracto

Estoy desarrollando un bot de tarot en Python que simule la experiencia de una lectura real. Utilizando ChatGPT como motor de lenguaje natural, el bot será capaz de manejar una baraja virtual, crear tiradas personalizadas, y ofrecer interpretaciones detalladas basadas en las cartas seleccionadas.

Con una interfaz tanto para Discord como para web, este proyecto busca brindar acceso a lecturas de tarot a un público amplio, incluyendo aquellos que no tienen una baraja física, quienes buscan una lectura rápida y sencilla, o aquellos que desean reducir su dependencia en lecturas constantes.

El objetivo es crear una herramienta intuitiva y confiable que preserve la esencia de una lectura de tarot tradicional, adaptada a la era digital.

Descripción de proyecto

Creación de aplicación de Python con las capacidades técnicas de un tarotista; manejo de baraja, creación de barajas para propósitos específicos, mezclado de baraja, colocación de cartas y dar su significado. Emplear un LLM para generar interpretaciones de las lecturas generadas. Darle a este dos UIs, una como bot de Discord y otra como aplicación web.

Necesidades que cubre el proyecto

• Quienes que por algún motivo no pueden tener una baraja de tarot, pero tienen interés en su uso.
• Quienes no tienen energía y/o capacidad para hacer sus propias lecturas.
• Quienes tienen dependencia a las lecturas y quieren reemplazarlo.

Actividades identificadas

Parte 1: el core

1. Manejo de baraja/cartas
   1. Crear sistema de identificadores de las cartas
   2. Método de creación de identificadores
   3. Método de creación de barajas
2. Mezclado de barajas
   1. Aleatorización de cartas
   2. Mezclado en abanico
   3. Aleatorizar sentido
3. Colocación de cartas
   1. Jalar cantidades específicas de cartas
   2. Mostrar opciones de selección
   3. Opción de tomar por arriba, por abajo y por en medio
4. Dar su significado/relaciones por carta
   1. Crear sistema de archivos
   2. Rellenar archivos
   3. Crear sistema de extracción de información de archivos
   4. Crear plantilla de texto para la información.
5. Crear bucle de trabajo base
   1. Crear diagrama de flujo de las interacciones con el bot
   2. Guionizar interacciones con el bot
   3. Crear bucle
6. Pruebas y documentación
   1. Crear documentación interna
   2. Crear documentación general externa
   3. Crear unittests

Parte 2: simular humanidad

7. Integrar openai en el bucle de trabajo

Parte 3: Darle GUI

8. Crear bot de Discord
9. Crear aplicación web

Sobre el tarot

El tarot, en esencia, es un sistema de símbolos y arquetipos que se utiliza para la introspección y la orientación. Es una herramienta que ofrece perspectivas sobre diversas situaciones de la vida y ayudando a los consultantes a conectar con su intuición y, para algunos, con guías espirituales.

De acuerdo a Wikipedia, el tarot (originalmente conocido como trionfi y posteriormente como tarocchi o tarocks) es una baraja de naipes a menudo utilizada desde por lo menos mediados del siglo XV en varias partes de Europa para jugar juegos de cartas tales como el Tarocchini.

A finales del siglo XVIII, ocultistas franceses hicieron afirmaciones elaboradas, pero no corroboradas, sobre la historia y significado de las cartas, lo que llevó a la aparición de barajas personalizadas para ser usadas en la adivinación usando las cartas del tarot para obtener conocimiento o intuiciones sobre el pasado, el presente o el futuro.

Es usado desde entonces como medio de consulta e interpretación de hechos (presentes, pasados o futuros), sueños, percepciones o estados emocionales, y constituye, pues, un tipo de cartomancia.

Como se lee el tarot.

En las lecturas hay dos partes; la tirada, que puede considerarse una receta y las cartas, que vendrian a ser los ingredientes.

La tirada es un patron de colocacion de cartas, donde a cada lugar se le da un area o se le hace una pregunta.

El trabajo del tarotista es interpretar como la carta responde a la pregunta o describe el area.

Sobre las cartas

El tarot está compuesto de 78 cartas, divididas en 22 arcanos mayores y 56 menores, que a su vez se dividen en 4 palos; espadas, bastos, copas y oros/pentáculos. Cada uno con 14 cartas, numerados del 1 al 10, y después sota, caballero, reina y rey.

El arte de las cartas representa el significado de estas y cuenta una historia.

El significado cambia acorde a la dirección, teniendo un significado al estar normal y otro al estar invertida.

Cada uno de los palos tiene un area de influencia y un elemento relacionado.

De entre los arcanos menores, 36 tienen una relación con un demonio del Ars Goetia. 9 por palo, las numeradas del 2 al 10. Cada una de estas cartas tiene relación con 2 de los 72 demonios. Uno diurno y uno nocturno.

Los arcanos mayores suelen llevar la numeracion romana y algunos de ellos estan relacionados con un arquetipo jungeano.

Creando identificadores

Como mencioné en la introducción, las barajas del tarot se dividen en 2 grupos: la arcana mayor, que contiene 22 cartas, y la arcana menor con 56 cartas divididas en 4 palos, contando cada palo con 14 cartas.

Entonces, el tarot tiene 5 grupos de cartas. Para facilitar el manejo de las cartas, decidí darles un identificador alfanumérico único con el formato G00. G siendo el identificador del grupo y 00 el número de la carta.

Al principio consideré 2 opciones para la identificación: la alfanumérica, ganadora, y un potencial identificador numérico, descartado por el pecado de dificultar el mantenimiento, la reutilización del módulo y los archivos con la información de las cartas. Esta decisión, a la larga, demostraría ser la mejor.

La parte "alfa" de alfanumérica fue fácil de definir; una letra distinta para cada grupo, listo. M de arcana mayor, E de espadas, C de copas, B de bastos (V de varas, no, siendo completamente sincera, no me gustaba cómo se veía junto con las otras) y P de pentáculos (porque, nuevamente, no me gustaba cómo se veía la O de oros). Creando la nomenclatura MECBP, pronunciado mec-bep.

La parte "numérica" de alfanumérica presenta aún menos dificultades. El uso del sistema hexadecimal fue descartado inmediatamente, pues considerando que la arcana mayor tiene 22 integrantes, no ahorraría espacio. Por practicidad, todos los identificadores debían tener exactamente la misma cantidad de caracteres; por ello, se determinó el uso de 2 posiciones numéricas.

La otra característica, la posición

Hay otra variable muy importante a considerar durante las lecturas, y esa es la posición en la que se encuentran las cartas, pudiendo ser esta recta o invertida. Recta, normal, para arriba. Invertida, al revés, para abajo.

Para facilitar la posible consulta de los datos, añadí una tercera posición, la neutra. Teniendo entonces tres posiciones Recta, Inversa y Neutra. Creando la nomenclatura RIN, pronunciada "rin".

El sistema: G00P

Llamé al sistema completo G00P, pronunciado goop; G de grupo (MECBP), los dos ceros de las dos posiciones numéricas y la P de posición (RIN). Este sistema es manejable en archivos, fácil de acceder y mantener.

Todo el manejo de la baraja se realiza con la clase Deck. Esta tiene 3 y solamente 3 atributos:

deck (lista, inicialmente vacía):

Un listado de los identificadores G00P que contiene la baraja

hand (lista, inicialmente vacía):

Listado de las cartas seleccionadas para ser colocadas en el spread / tirada

suits (set ("E","C","B","P")):

Los posibles valores de los palos en G00P, omitiendo M, ya que este se maneja aparte.

Considerando que las posiciones R o I se dan al barajear, la posición N se coloca por defecto.

Armando barajas

Muchas tiradas no requieren de la baraja completa; para obtener respuestas específicas, se puede reducir a un grupo específico de cartas.

Algunas requieren únicamente a los arcanos mayores, otras, solo un palo de los arcanos menores, porque se busca consultar la numeración. Las lecturas enfocadas a los goetia, requerirán únicamente las cartas con relación goetia.

Para reducir las barajas, yo suelo hacer las siguientes preguntas:

1. ¿Se incluyen los arcanos mayores?

   • Sí (pasar a P2)
   • No (pasar a P3)

2. ¿Se incluyen únicamente los arcanos mayores?

   • Sí (baraja terminada, solo arcanos mayores)
   • No (pasar a P3)

3. ¿Se incluyen todos los palos de los arcanos menores?

   • Sí (pasar a p5)
   • No (pasar a p4)

4. ¿Qué palos se incluyen?

   Selección múltiple, mínimo 1:

   • Espadas
   • Copas
   • Varas
   • Oros
   • Random, no importa cual.

   Pasar a P5

5. ¿Se incluyen todos los números?

   • Sí (baraja terminada)
   • No (pasar a P6)

6. ¿Qué números se incluyen?

   Seleccionar 1:

   • Solo las numeradas (del 1 al 10)
   • Solo las Goetia (del 2 al 10)

   Baraja terminada

Creando la baraja (en base a un comando de texto)

Considerando estos puntos, definí reglas de creación de baraja, que funcionan como variables de comando. Siendo estas:

onlymajor:

Únicamente arcana mayor

nomajor:

La arcana mayor no se incluye

suite:

Se incluye el palo de espadas

suitc:

Se incluye el palo de copas

suitb:

Se incluye el palo de varas

suitp:

Se incluye el palo de oros

suitr:

Se incluye un palo aleatorio, estos pueden acumularse, siendo el máximo reconocido 3. Superando estos, simplemente se añaden todos los palos a la lista de reglas.

numbered:

De la arcana menor, solo las cartas numeradas (del 1 al 10)

goetia:

De la arcana menor, solo las cartas con relación goetia (del 2 al 10)

Barajear la baraja (digital)

Ya con la baraja hecha, el primer cambio que se le hace es barajearla. Este proceso les da una posición (RI) y al aleatorizarlas se da ingreso a la suerte y se puede realizar la lectura.

Al no tener las cartas físicas, el mezclado y la asignación de posición se realizan por separado. Veamos primero la posición.

Trabajando el RI: generando posición

Para la generación de posición se usa una "lucky string" o cadena de la suerte. Esta, a diferencia de la de Carmen, no se pierde. Se genera una string con una cantidad aleatoria de R e Is, entre 5 y 15 + una pequeña varianza dada por los "tips" que se obtienen del usuario.

Esta cadena de Rs e Is se convierte en lista y se aleatoriza. Con esto, carta por carta, se elige un punto igual aleatorio de la cadena.

¿Qué tanto puede variar la cantidad de cartas rectas e invertidas en una baraja usando este algoritmo? Para refinar los datos de creación de baraja, genere las posiciones de una baraja completa 250 mil veces y recopile las proporciones de R e I. En la siguiente tabla puede verse la cantidad de cartas invertidas presentes en esta muestra.

Grafico de frecuencia de I

Barajeado por la maquina

Para el barajeado de naturaleza completamente digital, computacional y difícilmente replicable por el humano, decidí usar el método shuffle del módulo random (te amamos random). Si bien muchas teclas se han desgastado discutiendo si la aleatorización computacional es válida o fiable, porque, realmente, no es aleatoria, sino que es generada, el barajeado humano tampoco es tan aleatorio. 

Para esta aplicación, los generadores de números pseudoaleatorios (PRNGs) que podemos considerar el "barajeado" de la máquina; a pesar de ser influenciado por los nanosegundos, la entropia y los fotones, es perfecto.

Barajeando como humano (casi)

Los humanos barajean por lo general de dos maneras; en abanico y en bloque o corte. Llamé "abanico" el dividir la baraja en dos o más partes y mezclarlas, si bien hay muchísimas técnicas para hacer esto físicamente, solo buscamos emularlo lo más cercano posible. La otra forma es cortar o de bloque. En este, se divide la baraja en varias partes y se cambia la posición en la que estaban, sin mezclar los bloques entre sí.

Estas dos comparten una característica: se tiene que dividir la baraja en varias (mínimo 2) partes. Para esa labor, cree un método estático.  Y otro para verificar que la cantidad de partes que se busca cortar sea viable, es decir, si me pidieras cortar una baraja que tiene solo la arcana mayor (de 22 cartas) en 25 partes, sería imposible. Si me pides que la parta en 22 incluso, sería algo más cercano al hard_mix, se perdería por completo la "energía" o entropía que lleva la baraja.

El mínimo de partes es 2, se necesitan mínimo dos partes para que se pueda hablar de partes en plural, pero ¿por qué la cantidad máxima de partes es una cuarta parte de la cantidad de cartas en la baraja? Bueno, por una pequeña limitación que me encontré durante una de las primeras pruebas de la clase ya integrada.  Un problema proveniente de mi propia ambición: la creación de barajas goetia.

Si bien en la práctica cualquier lectura que se limite a las cartas goetia incluye todos los palos, por cómo funciona la creación de las barajas, es perfectamente viable pedir una baraja que tenga solo un palo y solo las cartas goetia. Por ello, que la baraja más pequeña posible es una de 8 cartas.

Inicialmente, el número máximo de partes era una quinta parte de la cantidad de cartas. En mi consideración, este número era ideal. La baraja más pequeña de uso común es la numerada de un palo, con 10 integrantes, 10 entre 5 da 2, dos integrantes mínimos por parte. Por supuesto, esto pasa a ser imposible en la baraja más pequeña creable, 8 entre cinco da 1.6 y al momento de crear el rango de posibilidades, el número máximo resulta menor que el mínimo.

Podríamos, por supuesto, hacer imposible la creación de una baraja así en la GUI, pero si alguien modificara los archivos para que pidan una baraja así, el crearla resultaría en un error fatal. El peor tipo de errores.

Abanico

Técnicamente, ocurren 4 mezclados en esta función. Primero, el orden de las partes se revuelve. Segundo, cada una de las partes se revuelve entre sí. Tercero, las partes se unen en abanico, mezclándose entre ellas y creando nuevas partes y, por cuarto y último, las nuevas partes también se revuelve.

Después de mucha prueba y mucho error, quedé con esta función que permite la existencia de "pegados" (cuando dos cartas son consecutivas) esporádicos. Y se asegura de que la cantidad máxima de "pegados" sea 2. El resultado de esto es una mezcla de tarjetas que se siente natural y se mantiene aleatoria. 

Hilary Duff disfrutando su flip-phone en la película La Nueva Cenicienta.

Creando una guía de las cartas del Tarot

Al momento de redactar esta parte, te puedo decir, con profundo pesar y completa certeza, que esta fue la parte más agobiante, repetitiva y poco interesante de todo el proyecto.

En parte, me temo, porque en esto no recibí muchísimos conocimientos novedosos y cuando lo hice, tuve que usar cada milinewton de mi fuerza de voluntad para no caer en un agujero de conejo, que si bien me haría más sabia, podría descarrilar el proyecto por completo.

Más abajo puedes navegar cómodamente la información reunida sobre las cartas y los demonios del Ars Goetia.

Pero esa es la versión para consulta de humanos, la tercera versión para consulta humana, generada a partir de la versión para consulta del programa, que, a su vez, se derivó de la segunda versión para consulta humana, la cual es... complicada de navegar.

La versión para consulta desde el código es un conjunto de archivos json, con diferencias para la arcana mayor y la menor y un archivo extra por cada uno de los palos.

A continuación te muestro ejemplos de los 3 tipos de archivos para las cartas; E01 (menor sin goetia), E02 (menor con goetia) y M00 (mayor).