TaleWeaver

TaleWeaver is an AI-driven, text-based adventure game where your imagination leads the way. Whether you play solo or with friends, this game dynamically generates narratives that adapt to your choices, creating unique and immersive stories every time you play.

🌟 Features

• Dynamic Storytelling: Experience narratives that evolve based on your decisions, making each playthrough unique.
• Multiplayer: Play with friends and collaboratively create stories in real time.
• Customizable Worlds: Set the stage for your adventures with customizable world settings and parameters.
• Imagination-Powered Gameplay: The game’s narrative adapts to your creativity, offering endless possibilities.

🖥️ System Requirements

Minimum Requirements:

• Python: Version 3.12
• RAM: 4GB
• Free Disk Space: 500MB

Recommended Requirements:

• Python: Version 3.12
• RAM: 8GB or more
• Free Disk Space: 1GB

Notes:

• OS: Compatible with Windows, Linux, and macOS.

🚀 Installation

Prerequisites

1. Python 3.12: Ensure Python is installed on your system. You can download it from python.org.

2. Miniconda: Ensure Miniconda is installed. Don't forget to check Add to PATH during installation. Download it here Miniconda.

Steps

1. Clone the Repository:

   git clone https://github.com/vancoder1/TaleWeaver.git
   cd TaleWeaver

2. Install everything using install_windows.bat:

   .\install_windows.bat

3. Wait for the installation to complete.

📖 Usage

1. Put your GROQ API key into config.env

   GROQ_API = ""

2. Start the Application:

   To start server:

   .\start_server_windows.bat

   To start client:

   .\start_client_windows.bat

3. Follow the link in console to open WebUI in your browser

4. Begin Your Adventure:

   • Follow the prompts to create or join a story session.

5. Multiplayer Mode:

   • Share your IP (local COOP only) with friends to play together.
   • Collaborate on story decisions and see how the narrative evolves.

6. Custom World Settings:

   • Before starting, you can customize world settings like setting and your character.

🤝 Contributing

Contributions are welcome! If you have ideas, suggestions, or bug reports, feel free to open an issue or submit a pull request.

📜 License

This project is licensed under the MIT License.

🙏 Acknowledgements

• GROQ for providing the core AI models.

📬 Contact

For any questions or feedback, please open an issue on this repository or reach out to ivanzaporozhets25@gmail.com.