Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tegridydev/dnd-llm-game
MVP of an idea using multiple local LLM models to simulate and play D&D
https://github.com/tegridydev/dnd-llm-game
ai-dnd dnd llm llm-game llm-generator local local-ai localllm multi-ai multi-llm multiagent ollama ollama-python streamlit
Last synced: about 2 months ago
JSON representation
MVP of an idea using multiple local LLM models to simulate and play D&D
- Host: GitHub
- URL: https://github.com/tegridydev/dnd-llm-game
- Owner: tegridydev
- License: other
- Created: 2024-05-16T23:06:35.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-11-03T00:34:58.000Z (3 months ago)
- Last Synced: 2024-11-03T01:19:53.845Z (3 months ago)
- Topics: ai-dnd, dnd, llm, llm-game, llm-generator, local, local-ai, localllm, multi-ai, multi-llm, multiagent, ollama, ollama-python, streamlit
- Language: Python
- Homepage:
- Size: 205 KB
- Stars: 34
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome_ai_agents - Dnd-Llm-Game - MVP of an idea using multiple local LLM models to simulate and play D&D (Building / LLM Models)
- awesome_ai_agents - Dnd-Llm-Game - MVP of an idea using multiple local LLM models to simulate and play D&D (Building / LLM Models)
README
# TD-LLM-DND
TD-LLM-DND is a Streamlit-based web application that creates a Dungeons & Dragons style adventure using locally hosted llm from ollama.
Players can generate characters, start new adventures, and progress through turns with an automated Dungeon Master, AI powered party members and player interactions (TO:DO).
## Features
- **Generate D&D Characters**: Create unique characters with name, race, class, backstory, and items
- **Start New Adventure**: Begin a new adventure with the generated characters
- **Turn-Based Gameplay**: Progress through the adventure with player and Dungeon Master turns (TO:DO - add player input)
- **Manage Models**: Select/download and manage language models for the Dungeon Master and AI players
## Requirements
- Python 3.8+
- Streamlit
- Requests
- LangChain
- HuggingFace Transformers
- dotenv
## Installation
1. **Clone the repository**:
```
git clone https://github.com/tegridydev/dnd-llm-game.git
cd td-llm-dnd
```
2. **Create and activate a virtual environment**:
```
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
```
3. **Install the dependencies**:
```
pip install -r requirements.txt
```
4. **Set up environment variables**:
Create a `.env` file in the root directory with the following content:
```plaintext
OLLAMA_API_ENDPOINT=http://localhost:11434/api/generate
PDF_FOLDER=pdf
CHROMA_DB_DIR=./chroma_db
TURN_LIMIT=10
```
## Usage
1. **Start Ollama**:
```
ollama serve
```
2. **Run the Streamlit app**:
```
streamlit run app.py
```
3. **Access the app**:
Open your browser and go to `http://localhost:8501`.
## How to Play
1. Generate a new party.
2. Start a new adventure.
3. Play the next turn.
May your dice roll high!
## Contributing
Contributions are welcome! Please fork the repository and submit a pull request!