Git Product home page Git Product logo

tale's Introduction

T.A.L.E. (Transformative AI for Legendary Epics)

Overview

Welcome to T.A.L.E., a groundbreaking tool for role-playing game enthusiasts! T.A.L.E. elevates your RPG experiences by transforming your session notes into an engaging website. This is achieved using the advanced capabilities of OpenAI's GPT-3.5-turbo and DALL-E-3 APIs, bringing a new dimension to your RPG narratives.

In short, this means you can turn your boring, plain notes into an aesthetic experience like this:

Showcase

Features

  • Automatic Summarization: Transforms detailed RPG notes into succinct, engaging summaries.
  • AI-Generated Imagery: Enhances summaries with captivating images generated by DALL-E-3, tailored to the context of your adventure.
  • Web Generation: Automatically crafts a visually rich website to showcase your RPG sessions.

Getting Started

Prerequisites

  • Python 3.x
  • Docker (Optional, recommended for a containerized environment)
  • OpenAI API keys for GPT-3.5-turbo and DALL-E-3
  • Roleplaying notes in a .txt-file.

Installation

  1. Clone the repository:
    git clone https://github.com/your-username/TALE.git
  2. Navigate to the cloned directory:
    cd TALE
  3. Install dependencies:
    pip install -r requirements.txt

Configuration

  1. Insert your OpenAI API keys in secret.txt.
  2. Put your roleplaying notes as .txt file in data/input/notes
    • You can add as many .txt files here as you want. Theoretically, the framework works with notes from different players in one session
  3. For best results modify the file data/input/context.json. The JSON works like this:
    {
     "character1" : "prompt description of character",
      "place1" : "prompt description of place",
      ....
    }

Running T.A.L.E.

Run the following command:

python tale/tale.py

This processes your RPG notes, creates summaries and images, and assembles a website in data/output.

Output

The generated website will be in data/output. Access output.html to explore your RPG session stories and accompanying visuals.

Best Practices

  • Regularly update your notes for accurate summaries.
  • Monitor API usage to manage costs.
  • Keep backups of original notes.
  • Use context.json to ensure that character & place descriptions remain consistent
  • Try being precise in your roleplaying notes i.e. always write down names of people & places of action

Limitations / Known Issues

Dependent on OpenAI API availability and limits.

Sometimes the pipeline still breaks due to formatting issues. This is because the GPT-3.5 response is not always correct and can break by:

  • Not outputting correct .json formats in-between

  • Not matching images and text correctly

  • Generating image prompts that might get rejected by the image generation API

  • Generating outputs that are too long for the next steps

    We are aware of such issues and will work on improving them over time.

Obtaining OpenAI API Key and Costs

To obtain an API key, visit OpenAI's API page. Costs vary based on usage; see OpenAI's pricing page for details. Please take not that especially image generation can be pricey over time.

Further Work

We are planning on eventually improving T.A.L.E. by including GUI components and making outputs more interactable as well as the pipeline more reliable. Please be aware that we are working on this project in our free-time so changes might take some time.

Acknowledgments

  • OpenAI for the GPT-3.5-turbo and DALL-E-3 APIs
  • All contributors and supporters of the T.A.L.E. project

tale's People

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.