{"id":22412581,"url":"https://github.com/tegridydev/dnd-llm-game","last_synced_at":"2025-03-17T16:12:30.336Z","repository":{"id":240142087,"uuid":"801786026","full_name":"tegridydev/dnd-llm-game","owner":"tegridydev","description":"MVP of an idea using multiple local LLM models to simulate and play D\u0026D","archived":false,"fork":false,"pushed_at":"2024-11-03T00:34:58.000Z","size":211,"stargazers_count":62,"open_issues_count":4,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-04T21:01:53.829Z","etag":null,"topics":["ai-dnd","dnd","llm","llm-game","llm-generator","local","local-ai","localllm","multi-ai","multi-llm","multiagent","ollama","ollama-python","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tegridydev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-16T23:06:35.000Z","updated_at":"2025-03-02T18:51:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"dc5a0d8b-a8f0-4374-b739-da34cb887e8b","html_url":"https://github.com/tegridydev/dnd-llm-game","commit_stats":null,"previous_names":["tegridydev/dnd-llm-game"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tegridydev%2Fdnd-llm-game","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tegridydev%2Fdnd-llm-game/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tegridydev%2Fdnd-llm-game/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tegridydev%2Fdnd-llm-game/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tegridydev","download_url":"https://codeload.github.com/tegridydev/dnd-llm-game/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244066189,"owners_count":20392406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-dnd","dnd","llm","llm-game","llm-generator","local","local-ai","localllm","multi-ai","multi-llm","multiagent","ollama","ollama-python","streamlit"],"created_at":"2024-12-05T14:09:34.185Z","updated_at":"2025-03-17T16:12:30.317Z","avatar_url":"https://github.com/tegridydev.png","language":"Python","funding_links":[],"categories":["Building"],"sub_categories":["LLM Models"],"readme":"# TD-LLM-DND\n\nTD-LLM-DND is a Streamlit-based web application that creates a Dungeons \u0026 Dragons style adventure using locally hosted llm from ollama.\n\nPlayers can generate characters, start new adventures, and progress through turns with an automated Dungeon Master, AI powered party members and player interactions (TO:DO).\n\n![screen](/current/td-llm-dnd.png)\n\n## Features\n\n- **Generate D\u0026D Characters**: Create unique characters with name, race, class, backstory, and items\n- **Start New Adventure**: Begin a new adventure with the generated characters\n- **Turn-Based Gameplay**: Progress through the adventure with player and Dungeon Master turns (TO:DO - add player input)\n- **Manage Models**: Select/download and manage language models for the Dungeon Master and AI players\n\n## Requirements\n\n- Python 3.8+\n- Streamlit\n- Requests\n- LangChain\n- HuggingFace Transformers\n- dotenv\n\n## Installation\n\n1. **Clone the repository**:\n    ```\n    git clone https://github.com/tegridydev/dnd-llm-game.git\n    cd td-llm-dnd\n    ```\n\n2. **Create and activate a virtual environment**:\n    ```\n    python -m venv venv\n    source venv/bin/activate  # On Windows, use `venv\\Scripts\\activate`\n    ```\n\n3. **Install the dependencies**:\n    ```\n    pip install -r requirements.txt\n    ```\n\n4. **Set up environment variables**:\n    Create a `.env` file in the root directory with the following content:\n    ```plaintext\n    OLLAMA_API_ENDPOINT=http://localhost:11434/api/generate\n    PDF_FOLDER=pdf\n    CHROMA_DB_DIR=./chroma_db\n    TURN_LIMIT=10\n    ```\n\n## Usage\n\n1. **Start Ollama**:\n    ```\n    ollama serve\n    ```\n\n2. **Run the Streamlit app**:\n    ```\n    streamlit run app.py\n    ```\n\n3. **Access the app**:\n    Open your browser and go to `http://localhost:8501`.\n\n## How to Play\n\n1. Generate a new party.\n2. Start a new adventure.\n3. Play the next turn.\n\nMay your dice roll high!\n\n## Contributing\n\nContributions are welcome! Please fork the repository and submit a pull request!\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftegridydev%2Fdnd-llm-game","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftegridydev%2Fdnd-llm-game","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftegridydev%2Fdnd-llm-game/lists"}