temporal traverse

Descripción general

Este repositorio contiene código para un juego de aventura interactivo basado en texto llamado "Temporal Traverse". Los jugadores navegarán por un personaje llamado Alex durante varios períodos de tiempo, tomando decisiones que determinan el camino de la narración y, en última instancia, el destino de Alex. El juego está impulsado por Cassandra para la historia del chat y el modelo de lenguaje basado en IA desde OpenAI para generar respuestas.

Requisitos

• Python 3.x
• Un clúster de Cassandra (o usar Astradb) para almacenar el historial de chat
• Clave de API de OpenAI para la generación de idiomas

Configuración

1. Configuración de Cassandra

   • Asegúrese de tener un grupo de Cassandra o Astradb configurado. Actualice la variable cloud_config con las credenciales apropiadas en el código.
   • Reemplace secure-connect-choose-your-adventure.zip con el paquete correspondiente a su configuración de Cassandra o Astradb.

2. Variables de entorno

   • Almacene sus credenciales de Cassandra y OpenAI en un archivo llamado token.json .
   • Configure un archivo .env y agregue la variable OPENAI_API_KEY .

3. Clave de API de OpenAI

   • Para aprovisionar una clave API de OpenAI, visite el sitio web de OpenAI y cree una clave API. Inserte esta clave como el valor para OPENAI_API_KEY en su archivo .env .

4. Aprovisionamiento de base de datos vectorial

   • Este juego utiliza Cassandra para el almacenamiento del historial de chat, pero también puede integrar una base de datos vectorial para funcionalidades avanzadas. Provise una base de datos vectorial para una capa de datos adicional para admitir consultas y análisis de datos complejos.

5. Reglas y narrativas del juego

   • La narrativa y las reglas del juego se definen dentro del guión de Python. Los jugadores guiarán a Alex a través de la Traverse temporal, tomando decisiones que afectan la historia. El juego termina cuando un camino conduce a "el final".

Cómo jugar

1. Ejecución

   • Ejecute el guión de Python para comenzar el juego.

   código de bashcopy

   python connect-database.py

2. Jugabilidad

   • El juego se inicia eligiendo un dispositivo de viaje en el tiempo para el transporte.
   • Los jugadores encontrarán puntos de decisión en los que deben tomar decisiones, cada uno afectando la dirección de la historia.
   • Después de tres puntos de decisión, se presentan caminos que conducen a la muerte potencial del personaje, y el juego termina al encontrarse con "el final".

Historial de chat y modelo de IA

El juego utiliza una historia de chat almacenada en Cassandra a través de CassandraChatMessageHistory . Este contexto ayuda al modelo AI (LLMChain) de OpenAI para generar respuestas basadas en la entrada del jugador y la plantilla narrativa establecida.

Contribución

¡Las contribuciones son bienvenidas! Si desea mejorar el juego, no dude en bifurcar el repositorio y enviar una solicitud de extracción con sus cambios.

Licencia

Este proyecto tiene licencia bajo la licencia MIT. Siéntase libre de modificarlo y distribuirlo según los términos de la licencia.

Descargo de responsabilidad

Este juego es una demostración y debe usarse de manera responsable. El contenido generado por IA podría no siempre seguir un camino predecible o deseado debido a su naturaleza de aprendizaje.

Gracias por ver el repositorio temporal de los juegos de aventura Traverse. ¡Disfruta de tu viaje a través del tiempo y la narración de historias! Si tiene alguna consulta o sugerencia, no dude en comunicarse o crear un problema en el repositorio.