🌿EcoQuest: A Solarpunk Adventure🌿

Table of Contents

• Introduction
• Live Demo
• Game Overview
  • Key Features
• The Solarpunk Ethos
• Gameplay Structure
• Player Interaction
• Installation Instructions
• Contribution and Feedback

Introduction

Welcome to the GitHub repository for EcoQuest, an innovative educational app that leverages the power of Generative AI to inspire and educate players about environmental sustainability and the solarpunk movement. In EcoQuest, players step into the role of a Solarpunk Master, facing a series of environmental challenges that require creativity, critical thinking, and a deep understanding of ecological principles, enhanced by the interactive and adaptive capabilities of Generative AI.

Live Demo

Experience EcoQuest directly through our live demo: EcoQuest Demo.

Game Overview

EcoQuest is not just a game; it's a journey through various environmental scenarios, ranging from local neighborhoods to global landscapes, facilitated by cutting-edge AI technology. As players progress, they tackle increasingly complex challenges, each demanding a unique blend of problem-solving skills and sustainable thinking, guided by the intelligent responses and scenarios generated by AI.

Key Features:

• Engaging Storylines: Immerse yourself in diverse environmental scenarios, each with its unique challenges and characters, dynamically created by Generative AI.
• Educational Content: Learn about real-world environmental issues and the principles of sustainability embedded in the gameplay, all presented through an AI-driven narrative.
• Creative Problem-Solving: Develop and propose innovative solutions to ecological challenges, with AI providing dynamic feedback and suggestions.
• Interactive Gameplay: Engage in a dynamic dialogue with the game's AI assistant, exploring different aspects of each challenge.
• Progress Tracking: Earn points and achievements for successfully solving problems, reflecting your journey towards becoming a Solarpunk Master.

The Solarpunk Ethos

Solarpunk is a movement that envisions how the future might look if humanity succeeded in solving major contemporary challenges with an emphasis on sustainability, community, and environmental health. EcoQuest embodies this ethos, encouraging players to think about how their actions impact the world around them, with the support of AI to deepen the learning experience.

Gameplay Structure

EcoQuest is structured across three levels of play:

1. Local Level: Address environmental issues in small communities or urban areas.
2. Regional Level: Tackle broader, more complex challenges that affect larger regions.
3. Global Level: Confront global environmental issues, requiring comprehensive and innovative solutions.

Player Interaction

Players are encouraged to:

• Propose solutions to presented environmental challenges.
• Engage in back-and-forth dialogues with the in-game AI assistant for hints and guidance.
• Conduct independent research to enhance their understanding and problem-solving skills.

Installation Instructions

To install and run EcoQuest, follow these steps:

1. Clone the Repository:

   • Use git clone https://github.com/oicaroabreu/llm-eco-quest.git to clone the repository to your local machine.

2. Install Dependencies:

   • Navigate to the cloned directory.
   • Run pip install -r requirements.txt to install necessary Python packages.

3. Set Up OpenAI API Key:

   • Ensure you have an OpenAI API key. If not, obtain it from OpenAI.
   • Add the key to your environment variables, in the ./streamlit/secrets.toml file or directly in the app as instructed within the game interface.

4. Run the Game:

   • Execute streamlit run app.py to start the game.
   • Open the local URL provided by Streamlit in your web browser.

For detailed instructions and troubleshooting, please refer to the README.md in the repository.

Contribution and Feedback

We welcome contributions and feedback from environmental enthusiasts, game designers, educators, and anyone interested in sustainability and gaming. Whether it's suggesting new features, improving the storyline, or offering educational content, your input is invaluable.

---

🌿 Embark on your Solarpunk journey with EcoQuest, enhanced by Generative AI, and make a difference, one challenge at a time! 🌿