StoryTeller Agent

StoryTeller Agent is an interactive and narrative story generator that creates adventorous stories in the worlds of their Choice. User is prompted with the world they want to explore and story evolves based on their choices.

Project structure

directories

• notebooks contains playground.ipynb that served as a playground during the implementation phase.
• src contains all the core logic
  • config.py has all the metadata it requires to function
  • edges.py includes conditional routing logic for LangGraph
  • graph.py actual implementation of the LangGraph workflow
  • llm_model.py has logic to create LLM client
  • nodes.py includes all the nodes for LangGraph
  • response.py a simple wrapper around LangGraph's streaming capabilities to output everything in console in real time
  • state.py contains State metadata for LangGraph
  • main.py logic related to whole app execution

Usage

To run the project clone the repo:

https://github.com/georgetsouvaltzis/storyteller-agent.git

then navigate to project repo by using

cd storyteller-agent/src

create .env file based on .env.example

cp .env.example .env

provide GROQ_API_KEY (required) in .env file:

GROQ_API_KEY="your-key-here"

create and activate virtual environment(.venv):

python3 -m venv .venv
source .venv/bin/activate

install project requirements:

pip install -r requirements.txt

run the project:

python main.py