https://github.com/hecatops/spiel
A lightweight, RAG-powered interactive text adventure engine built with Streamlit and Mistral API. Create immersive story experiences from a single prompt.
https://github.com/hecatops/spiel
game llm mistral streamlit text-adventure
Last synced: about 2 months ago
JSON representation
A lightweight, RAG-powered interactive text adventure engine built with Streamlit and Mistral API. Create immersive story experiences from a single prompt.
- Host: GitHub
- URL: https://github.com/hecatops/spiel
- Owner: hecatops
- Created: 2025-05-17T07:40:54.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-16T17:49:28.000Z (4 months ago)
- Last Synced: 2026-02-17T00:26:35.734Z (4 months ago)
- Topics: game, llm, mistral, streamlit, text-adventure
- Language: Python
- Homepage: https://spiellm.streamlit.app/
- Size: 18.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎭 Spiel
**Spiel** is a lightweight, creative text adventure engine that turns your ideas into playable, choice-based stories — powered by LLMs and RAG. You give it a prompt, and it spins the tale.
Built with [Streamlit](https://streamlit.io) and [Groq](https://chat.groq.com) for simplicity, speed, and storytelling magic.
---
## ✨ Features
- 🧠 Powered by Llama-3.3-70B-Versatile via API (works with the free tier)
- 🎮 Interactive gameplay with clickable choices (no typing needed)
- 🖼 Minimalist UI, no setup fuss
- 🔐 Secure API key via Streamlit secrets
---
## 🚀 Get Started
### 1. Clone & Install
```bash
git clone https://github.com/yourusername/spiel.git
cd spiel
pip install -r requirements.txt
```
### 2. Add Your Groq API Key
Replace API_KEY = st.secrets["API_KEY"] with
```bash
API_KEY = "YOUR_API_KEY"
```
### 3. Run the App
```bash
streamlit run spiel.py
```
Open http://localhost:8501 in your browser.