AI-Gamble: dynamisch generiertes, interaktives Romanspiel

AI-Gamble ist eine interaktive Plattform für fiktive Spiele, die auf Large Language Modelling (LLM) basiert. Sie generiert einzigartige Handlungsstränge, Charaktere und visuelle Storyline-Diagramme in Echtzeit, basierend auf dem vom Spieler gewählten Story-Genre (z.B. Eastern Fantasy, Western Magic, etc.) durch AI-Technologie. Die Spieler können durch einfache Entscheidungen in die verzweigte Geschichte eintauchen und mehrere Enden der Geschichte erkunden. Das Projekt verwendet FastAPI-Backend, Vanilla JavaScript-Frontend und Mermaid.js zum Rendern der Story-Strukturkarte, unterstützt die Docker-Bereitstellung und eignet sich für Benutzer, die interaktives Storytelling und KI-Technologie mögen. Das gesamte System ist so konzipiert, dass es effizient und einfach zu bedienen ist und sich für einen schnellen Start eignet.

Funktionsliste

• Dynamische Geschichtenerstellung Die KI generiert in Echtzeit Eröffnungen, Entwicklungen und mehrere Enden entsprechend der vom Spieler gewählten Art von Geschichte und unterstützt eine Vielzahl von literarischen Stilen wie östliche Fantasy und westliche Magie.
• Randomisierung von Schriftstellern und Werken Jedes Mal, wenn ein neues Spiel gespielt wird, generiert das System nach dem Zufallsprinzip virtuelle "Autoren" und "Buchtitel", die zur Art der Geschichte passen, was den Spaß und die Immersion erhöht.
• Visuelles Storyline-Diagramm Mermaid.js: Zu Beginn des Spiels wird eine Karte mit der Struktur der Geschichte generiert und im Frontend angezeigt, so dass der Spieler die Zweige und Enden der Geschichte intuitiv verstehen kann.
• verzweigte Erzählung Jede Entscheidung, die der Spieler trifft, ändert die Richtung der Geschichte und führt zu verschiedenen Handlungssträngen und Enden, was die Interaktivität erhöht.
• Dynamischer Schreibstil AI: Passen Sie den Erzählstil an die Art der Geschichte an, z. B. Antike oder Fantasy, um das Eintauchen in die Geschichte zu verbessern.

Hilfe verwenden

Einbauverfahren

AI-Gamble ist ein Docker-basiertes Projekt, das einfach zu installieren und für den lokalen Betrieb geeignet ist. Hier sind die detaillierten Schritte zur Installation und Nutzung:

Vorbedingung

• Installieren Sie Docker und Docker Compose.
• Bereiten Sie einen gültigen OpenAI-API-Schlüssel für den Aufruf des AI-Story-Generierungsdienstes vor.

Konfiguration der Umgebung

1. Erstellen einer Datei mit Umgebungsvariablen ::
   • Verwendung des Projekts .env Datei zum Speichern sensibler Informationen, wie OpenAI API-Schlüssel.
   • Kopieren Sie die mitgelieferten Beispieldateien in das Stammverzeichnis des Projekts:

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

2. Compiler .env Papiere ::
   • zeigen (eine Eintrittskarte) .env Datei, geben Sie Ihren OpenAI-API-Schlüssel ein.
   • Ändern Sie bei Bedarf andere Konfigurationen, wie z. B. die Datenbankverbindungsinformationen oder Redis-Einstellungen.

Initiierung von Projekten

1. Einrichtung und Betrieb des Dienstes ::
   • Führen Sie im Stammverzeichnis des Projekts den folgenden Befehl aus:

     docker-compose up --build
     

   • Dieser Befehl zieht die erforderlichen Images, erstellt und startet das FastAPI-Backend, Redis und andere Dienste.
2. Kompilieren von Frontend-Styles (optional) ::
   • Wenn Sie die CSS-Stile von Tailwind ändern müssen, öffnen Sie ein neues Terminal und starten Sie es:

     npm run build
     

   • Dieser Befehl sucht nach Front-End-Stil-Dateien und kompiliert sie in Echtzeit. tailwind.css.
3. Zugang zu Anwendungen ::
   • Öffnen Sie Ihren Browser und besuchen Sie http://localhost:1888.
   • Sobald die Seite geladen ist, wird der Hauptbildschirm des Spiels angezeigt, auf dem Sie die Art der Geschichte auswählen und das Spiel starten können.

Einstellung von Dienstleistungen

• drücken. Ctrl+C Stoppen Sie den Docker-Container.
• Wenn Sie den Behälter reinigen müssen, laufen Sie:

  docker-compose down
  

Verwendung

Neues Spiel beginnen

1. zeigen (eine Eintrittskarte) http://localhost:1888um den Hauptbildschirm des Spiels aufzurufen.
2. Wählen Sie die Art der Geschichte (z. B. "Eastern Fantasy" oder "Western Magic").
3. Klicken Sie auf die Schaltfläche "Start", und das System ruft die KI auf, um die Anfangsszene, den virtuellen Autor, den Buchtitel und den Handlungsverlauf zu erstellen.
4. Die Schnittstelle zeigt den Anfangsinhalt der Geschichte und die von Mermaid.js gerenderte Struktur der Geschichte an, wobei mögliche Verzweigungen und Enden angezeigt werden.

spielen

1. Lesen Sie eine Textbeschreibung der aktuellen Szene.
2. Folgen Sie den Aufforderungen, um eine Option auszuwählen (z. B. "In den Wald gehen" oder "Mit dem geheimnisvollen Mann sprechen").
3. Nachdem Sie Ihre Auswahl getroffen haben, generiert die KI auf der Grundlage Ihrer Entscheidung den nächsten Abschnitt der Geschichte, und die Benutzeroberfläche wird aktualisiert, um die neue Szene anzuzeigen.
4. Die Karte des Handlungsstrangs hebt dynamisch den Zweig hervor, in dem Sie sich gerade befinden, so dass Sie den Fortgang der Geschichte leicht verfolgen können.
5. Wähle weiter, bis die Geschichte ein bestimmtes Ende erreicht.

Storyline-Karte anzeigen

• In der Spieloberfläche zeigt Mermaid.js ein Storyline-Diagramm mit allen möglichen Verzweigungen und Enden an.
• Klicken Sie auf einen Knoten im Diagramm, um eine kurze Beschreibung des entsprechenden Szenarios anzuzeigen (sofern von der API unterstützt).
• Diagramme helfen den Spielern, die Auswirkungen ihrer Entscheidungen auf den Verlauf der Geschichte zu verstehen.

Verwalten von Spielsitzungen

• Ein neues Spiel erstellen : durch POST /api/v1/game Erstellen Sie ein neues Spiel und erhalten Sie die Anfangsszene und die Story Map.
• Auswahl einreichen : Verwendung POST /api/v1/game/{game_id}/choicedie Wahl des Spielers für die nächste Szene vor.
• Status anzeigen : durch GET /api/v1/game/{game_id} Holen Sie sich die aktuelle Westhaven AI-Gamble: dynamisch generierte interaktive Fiktion Spiel