AI-Gamble: jogo de ficção interativa gerado dinamicamente

O AI-Gamble é uma plataforma de jogos de ficção interativa baseada em Modelagem de Linguagem Grande (LLM). Ele gera enredos, personagens e diagramas visuais de enredo exclusivos em tempo real com base no gênero de história escolhido pelo jogador (por exemplo, fantasia oriental, magia ocidental etc.) por meio da tecnologia de IA. Os jogadores podem experimentar narrativas ramificadas imersivas e explorar vários finais de histórias por meio de escolhas simples. O projeto usa o back-end FastAPI, o front-end Vanilla JavaScript e o Mermaid.js para renderizar o mapa da estrutura da história, é compatível com a implantação do Docker e é adequado para usuários que gostam de contar histórias interativas e tecnologia de IA. Todo o sistema foi projetado para ser eficiente e fácil de operar, adequado para um início rápido.

Lista de funções

• Geração dinâmica de histórias A IA gera aberturas, desenvolvimentos e vários finais em tempo real, de acordo com o tipo de história escolhida pelo jogador, oferecendo suporte a uma variedade de estilos literários, como fantasia oriental e magia ocidental.
• Randomização de escritores e obras O sistema gera aleatoriamente "autores" e "títulos de livros" virtuais que correspondem ao tipo de história, aumentando a sensação de diversão e imersão.
• Diagrama visual da linha da história No início do jogo, um mapa da estrutura da história é gerado e exibido no front-end por meio do Mermaid.js, para que o jogador possa entender intuitivamente as ramificações e os finais da história.
• narrativa ramificada Cada escolha feita pelo jogador muda a direção da história, levando a diferentes enredos e finais, aumentando a interatividade.
• Estilo de escrita dinâmico IA: ajuste o estilo narrativo de acordo com o tipo de história, por exemplo, antiga ou de fantasia, para aumentar a imersão.

Usando a Ajuda

Processo de instalação

O AI-Gamble é um projeto baseado no Docker que é fácil de instalar e adequado para execução local. Aqui estão as etapas detalhadas de instalação e uso:

condição prévia

• Instale o Docker e o Docker Compose.
• Prepare uma chave de API OpenAI válida para chamar o serviço de geração de histórias de IA.

Ambiente de configuração

1. Criação de um arquivo de variável de ambiente ::
   • Uso do projeto .env para armazenar informações confidenciais, como chaves de API da OpenAI.
   • No diretório raiz do projeto, copie os arquivos de exemplo fornecidos:

     # Windows
     copy .env.example .env
     # macOS/Linux
     cp .env.example .env
     

2. compilador .env papéis ::
   • show (um ingresso) .env preencha sua chave de API da OpenAI.
   • Modifique outras configurações conforme necessário, como as informações de conexão do banco de dados ou as configurações do Redis.

Início de projetos

1. Colocar o serviço em funcionamento ::
   • No diretório raiz do projeto, execute o seguinte comando:

     docker-compose up --build
     

   • Esse comando extrai as imagens necessárias, cria e inicia o backend FastAPI, o Redis e outros serviços.
2. Compilar estilos de front-end (opcional) ::
   • Se você precisar modificar os estilos CSS do Tailwind, abra um novo terminal e execute-o:

     npm run build
     

   • Esse comando escuta e compila arquivos de estilo de front-end em tempo real. tailwind.css.
3. Acesso a aplicativos ::
   • Abra seu navegador e acesse http://localhost:1888.
   • Quando a página for carregada, você verá a tela principal do jogo, onde poderá selecionar o tipo de história e iniciar o jogo.

Descontinuação de serviços

• manter a mão sobre Ctrl+C Pare o contêiner do Docker.
• Se precisar limpar o contêiner, corra:

  docker-compose down
  

Uso

Iniciar novo jogo

1. show (um ingresso) http://localhost:1888para entrar na tela principal do jogo.
2. Escolha o tipo de história (por exemplo, "Fantasia Oriental" ou "Magia Ocidental").
3. Clique no botão "Start" (Iniciar) e o sistema chamará a IA para gerar a cena inicial, o escritor virtual, o título do livro e o diagrama da história.
4. A interface exibe o conteúdo de abertura da história e a estrutura da história renderizada pelo Mermaid.js, mostrando possíveis ramificações e finais.

jogar

1. Ler uma descrição de texto da cena atual.
2. Siga as instruções para escolher uma opção (por exemplo, "Enter the forest" ou "Talk to the mystery man").
3. Depois de enviar suas escolhas, a IA gera a próxima seção do conteúdo da história com base na sua decisão, e a interface é atualizada para mostrar a nova cena.
4. O mapa da linha da história destaca dinamicamente o ramo em que você está no momento, facilitando o acompanhamento do progresso da história.
5. Continue escolhendo até que a história chegue a um determinado final.

Exibir mapa da linha da história

• Na interface do jogo, o Mermaid.js renderiza um diagrama de linha de história mostrando todas as ramificações e finais possíveis.
• Clique em um nó no diagrama para visualizar uma breve descrição do cenário correspondente (se suportado pela API).
• Os gráficos ajudam os jogadores a entender o impacto das escolhas na direção da história.

Gerenciando sessões de jogos

• Criar um novo jogo : através de POST /api/v1/game Crie um novo jogo e obtenha a cena inicial e o mapa da história.
• Enviar seleção : Uso POST /api/v1/game/{game_id}/choiceEnvie a escolha do jogador para a próxima cena.
• Exibir status : através de GET /api/v1/game/{game_id} Obtenha o Westhaven AI-Gamble atual: jogo de ficção interativa gerado dinamicamente