Made with Supabase


Supa Adventure Saga is an interactive text-based roleplaying game powered by AI, where you create your character and embark on adventures. Using GPT as your Dungeon Master (DM), the game offers a blend of storytelling and player agency, immersing you in a world of fantasy and intrigue.

Supa Adventure Saga is a small side project for the Supabase Launch Week X Hackathon (December 2023). There are many opportunities for improvement and making the game more advanced, but we hope you enjoy the game as it is.

The game is made with streamlit, langchain and supabase as the main python frameworks.

Game Overview

In the small village of Eldenwood, you find yourself in the cozy Drunken Dragon Inn. A mysterious figure offers you a quest to investigate the haunted ruins of Graystone Castle, believed to be the source of recent villager disappearances. With a map and promise of gold, you set out to uncover the secrets lurking in the shadowy depths of the castle.

Your quest is to uncover the secrets lurking in the shadowy depths of the castle.


We use supabase for storing the message history of the game. During play relevant parts are retrieved using LangChain and a Supabase vector store based on the current prompt of the player. The idea is to add long term memory context for the LLM in addition to the recent most messages.


  • Clone the repository
  • Install dependencies: Install the required Python packages including Streamlit and LangChain.
  • Configure Supabase:
    • Set up a Supabase project and postgres database
    • Fill out the Supabase keys in a secrets.toml file in .streamlit (c.f. secrets.toml.example)
  • Configure OpenAI API Key: Enter your OpenAI API key in the Streamlit sidebar once the game is running to authenticate.

Playing the Game

Run the application:

streamlit run

Once the game is running follow the prompts to make your character and begin your adventure.


The idea behind the project is inspired by a langchain opengpts example:

The image for the game is made using DALL-E 3.

Related Projects

A project by Zernonia