EcoQuest is a comprehensive platform designed to promote environmental awareness and sustainability through interactive challenges, educational resources, and community engagement. Built primarily in Python, EcoQuest aims to gamify eco-friendly habits and empower users to make a positive impact on the planet.
- About
- Features
- Screenshots
- Installation
- Usage
- Project Structure
- Technologies Used
- Contributing
- License
- Contact
EcoQuest is an open-source project focused on encouraging sustainable living. Users participate in eco-challenges, track their progress, learn about environmental issues, and collaborate with a like-minded community. The platform is ideal for individuals, schools, and organizations looking to gamify green habits and environmental education.
- Interactive Eco-Challenges: Participate in daily, weekly, or custom challenges to promote eco-friendly actions (e.g., recycling, reducing water usage).
- Progress Tracking: Visualize your environmental impact and achievements over time.
- Educational Resources: Access articles, videos, and quizzes on environmental topics.
- Community Leaderboards: Compete and collaborate with friends, classmates, or coworkers.
- Rewards & Badges: Earn digital badges and rewards for completing challenges.
- Customizable Profiles: Personalize your avatar and share your progress.
- Notifications: Stay informed about new challenges and community milestones.
- Admin Dashboard: Tools for moderators to create challenges and manage content.
Add screenshots or GIFs to demonstrate the app. (You can add images to a
/assetsfolder and reference them here)
- Python 3.8+
- Pip (Python package manager)
- (Optional) Node.js & npm (if frontend is in JavaScript)
- Git
git clone https://github.com/SatyamPote/EcoQuest.git
cd EcoQuestpython -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activatepip install -r requirements.txtIf the project has a frontend:
cd frontend
npm install- Configure your database settings in
config.pyor.envas needed. - Run migrations or initialize the database:
# Example for Flask-Migrate
flask db upgradeStart the development server:
python app.pyOr, if using a framework:
flask run
# or
uvicorn main:app --reload # For FastAPIAccess the app at http://localhost:5000 (or the relevant port).
EcoQuest/
│
├── app.py # Entry point for the backend server
├── requirements.txt # Python dependencies
├── README.md # Project documentation
├── config.py # Configuration settings
├── /static # Static files (images, CSS, JS)
├── /templates # HTML templates (if using Flask/Django)
├── /frontend # Frontend code (if applicable)
├── /assets # Screenshots and demo images
├── /docs # Additional documentation
├── /tests # Test cases
└── ... # Other source files and modules
- Backend: Python (Flask / Django / FastAPI)
- Frontend: (If applicable) JavaScript (React / Vue.js), HTML, CSS
- Database: SQLite / PostgreSQL / MongoDB (customize as per your setup)
- Other: C++, C (for performance-critical features), Cython, PowerShell scripts
Contributions are welcome! Please follow these steps:
- Fork the repository.
- Create your feature branch:
git checkout -b feature/YourFeature - Commit your changes:
git commit -m 'Add some feature' - Push to the branch:
git push origin feature/YourFeature - Open a Pull Request.
Please read CONTRIBUTING.md if available, or open an issue for discussion.
This project is licensed under the MIT License. See the LICENSE file for details.
- Author: Satyam Pote
- Repository: github.com/SatyamPote/EcoQuest
- For bugs, suggestions, or feature requests, please open an issue.
"Be the change you wish to see in the world. Start your EcoQuest today!"