README.md

metadata

title: Sto RAI
emoji: ⚡
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 5.33.1
app_file: app.py
pinned: true
license: apache-2.0
tags:
  - agent-demo-track

Sto-rAI

Generating dynamic stories with a RPG flavor

Personal Motivations

Recently in my country, personality quizzes have been all the rage. These quizzes are usually by companies who want to engage their customers. They would integrate their products they are marketing into a quiz, and users would know which product of theirs best matches their personality. These quizzes tend to be story based, with users choosing what actions to take at each turn.

One fun aspect of this, on top of finding out what categories you fall into, is seeing what categories your friends would fall into as well. But what happens when both the quiz setter and taker does not know what happens next in the quiz?

How it works

In Sto-rAI, each newly encountered scenario is generated dynamically based on the user's previous actions up to that point. To come up with a coherent story, an agentic framework is used, with the following agents and their roles

• Orchestrator Agent: Assess the pace of the story and builds instructions related to tempo
• Storybuilder Agent: Depending on the pace and context of the story, builds the scenarios
• Narrator Agent: Crafts the question to the user, and decides on the transitions

Other agents used in the framework...

• Category Builder Agent: Creates categories that integrate the given category and story context (yes they don't have to be the same!)
• Evaluator Agent: Evaluates the user's story path and determines which category best fits them

Demos

Demos below are described with the intended actions at each section. Timestamps are written in seconds. Each demo lasts for 1 minute.

• Starting a new story from scratch
  • [00 - 02]: API key input
  • [02 - 14]: Giving context
  • [14 - 57]: Completing the quiz...
  • [57 - 60]: Agents evaluation!
• Continuing an existing story
  • [00 - 02]: API key input
  • [02 - 03]: Selection of existing story
  • [03 - 08]: In this first selection, the selection has been chosen before, so no generation takes place
  • [08 - 30]: Some selections were novel, so story was dynamically generated. The category Fire Blaze was previously discovered.
  • [30 - 45]: This quiz path results in a new category being discovered, Psychic Twist
  • [45 - 60]: Displaying story progress tree. Unexplored categories and nodes have their information hidden. For the nodes, the story has not even been generated yet!

Who would use this?

• People who want to generate stories for games, work or any reason, but are not creative (like me...)
• Those who want to decide on things by doing quizzes
• People who love category-based questionnaires and do them for fun
• Those who are really bored (and have some API credits to burn)