https://github.com/azzedde/llm_story_game

A small interactive game with an LLM that generate (not random ;) ) events and actions that you need to follow in order to win !
https://github.com/azzedde/llm_story_game

langchain llm openai python streamlit

Last synced: 4 months ago
JSON representation

A small interactive game with an LLM that generate (not random ;) ) events and actions that you need to follow in order to win !

• Host: GitHub
• URL: https://github.com/azzedde/llm_story_game
• Owner: Azzedde
• Created: 2024-09-09T02:49:28.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2024-09-09T03:10:19.000Z (5 months ago)
• Last Synced: 2024-10-12T23:42:16.257Z (4 months ago)
• Topics: langchain, llm, openai, python, streamlit
• Language: Python
• Homepage:
• Size: 122 KB
• Stars: 8
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        

### LLM Story Game

This interactive game challenges you to survive by keeping your HP above 0. You'll use mana to select the right actions, while the outcome of future events is influenced by your luck. Each event is visually represented by images generated using the Flux [dev] model with warm inference via Hugging Face.

To start playing, simply provide your OpenAI GPT API key and HuggingFace token in an `.env` file, as the game performs best when integrated with GPT models.

#### Features:

- **HP, Mana, and Luck system**: Manage your resources carefully to survive.

- **Dynamic event images**: Flux [dev] generates event images in real-time.

- **Luck-driven events**: Unpredictable outcomes based on your luck.

------

#### Architecture:

I used mainly langchain chains and well curated prompts to get the output as needed, then the hp,mana and luck setup was pure python programming. Everything was wrapped up in a streamlit app.

![LLM_Game](https://github.com/user-attachments/assets/bd498292-82ff-451d-bf18-6a631deca3aa)

------

#### Limitation: 

A big limitation about this project is that it takes so much time to generate images, I can't use flux on my poor 6Gb VRAM GPU since it take at least 22Gb to run it locally.

If you're interested in turning this small project into a wider one (or a commercial venture, or maybe a project that resambles it), feel free to contact me