Dungeo_ai

Dungeo_ai

this is a dungeon ai run locally that use your llm

Stars: 54

Visit
 screenshot

OpenSource AI Tool for interactive text adventure with AI-generated storytelling and optional TTS narration support. Explore, role-play, and create story-driven adventures using AI. Requires Python 3.10+, pip, Ollama, NVIDIA CUDA Toolkit, git, and AllTalk TTS. Includes different modes for varied experiences and commands for gameplay. Licensed under MIT License with credit requirement for commercial use.

README:


๐Ÿค– OpenSource AI Tool

Project Banner

๐ŸŒŸ What is This Project?

OpenSource AI Dungeon Adventure is a free and open-source interactive text adventure project with AI-generated storytelling and optional AllTalk TTS narration support.

Created with โค๏ธ for all ages, this project lets you explore, role-play, and create your own story-driven adventure using AI.

๐Ÿ›‘ Notice: This software is free for personal and educational use only. If you use it commercially or integrate it into monetized/restricted systems, YOU MUST CREDIT THE ORIGINAL AUTHOR.


โš™๏ธ Requirements

  • ๐Ÿ Python 3.10+
  • ๐Ÿ“ฆ pip (Python package installer)
  • ๐Ÿฆ™ Ollama (for local AI model inference)
  • ๐Ÿง  NVIDIA CUDA Toolkit (for GPU acceleration)
  • ๐Ÿงฐ git (optional but helpful)
  • ๐ŸŽค (optional) AllTalk TTS for narrated voice output

๐Ÿ“ฆ Installation

1๏ธโƒฃ Clone the Repository

git clone https://github.com/Laszlobeer/Dungeo_ai.git
cd Dungeo_ai

2A. Create a Virtual Environment (Python venv)

python -m venv Dungeo_ai
source Dungeo_ai/bin/activate  # On Windows: Dungeo_ai\Scripts\activate

2B. Create a Conda Environment (Optional)

conda create -n dungeo_ai python=3.10 -y
conda activate dungeo_ai

3๏ธโƒฃ Install Dependencies

pip install -r requirements.txt

๐Ÿ’ก If you get errors from requirements.txt, try installing manually:

pip requests sounddevice numpy soundfile

๐Ÿš€ Usage

๐Ÿงช Start the Adventure

python main.py

๐ŸŽญ Alternate Modes

Script Description
main.py The default AI dungeon adventure experience
funnymain.py A humorous and quirky version of the game
seriousmain.py A more immersive and serious roleplay with advanced class/ability logic

โœจ Use funnymain.py if you're looking for a laugh, or try seriousmain.py if you want a classic RPG-style experience with deeper presence, class systems, and improved logic!


๐Ÿ’ฌ Available Commands

/? or /help       - Show help message  
/censored         - Toggle NSFW/SFW mode  
/redo             - Regenerate last AI response  
/save             - Save the story to adventure.txt  
/load             - Load adventure from adventure.txt  
/change           - Switch to another Ollama model  
/exit             - Exit the game  

๐Ÿ“œ License & Credits

๐Ÿ†“ MIT License โ€” Free to use, modify, and distribute.

If you:

  • Use this commercially ๐Ÿข
  • Integrate into a monetized app ๐Ÿ’ต
  • Publicly modify/fork it

๐Ÿ‘‰ You MUST give credit to the original author.

โœ๏ธ Example Credit

This project is based on OpenSource AI Tool by [Laszlo](https://github.com/Laszlobeer/Dungeo_ai)

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for Dungeo_ai

Similar Open Source Tools

For similar tasks

For similar jobs