ecocycle 2.5

Cycle into a greener tomorrow.

[!WARNING] The software and files provided in this repository by Shirish Pothi and the EcoCycle team are provided "as is" and without warranties of any kind, express or implied. We disclaim all liability for any direct, indirect, incidental, special, or consequential damages arising out of the use or inability to use the software or any files in this repository. Use at your sole discretion and risk.

📂 Directory

📌 Quick Navigation

• 🏡 Home
• 📜 About EcoCycle
• 🚀 Live Demo
• 📦 Pip Library Compatibility
• 📜 License
• 📞 Contact

---

📁 EcoCycle Repo Structure

Click to expand 📂

• 📜 README.md → Project overview & setup
• 📜 Code of Conduct.md → Customised version of Contributor Covenant Code of Conduct Template, tailored to EcoCycle
• 📁 src/ → Source code
  • 📄 main.py → Core program logic
  • 📄 admin.py → Admin panel functionality
  • 📄 user.py → User profile management
• 📁 assets/ → Images & icons
  • 🖼️ EcoCycle_Logo_Rounded.png → Project logo
• 📁 docs/ → Documentation
  • 📄 installation.md → Setup guide
  • 📄 features.md → Feature explanations
• 📁 tests/ → Unit tests

EcoCycle - Cycle Into A Greener Tomorrow

Our program was originally developed for the Lenovo and Intel's EDUtech ASIA hackathon, under the sustainable campus theme.

Through deliberation, we decided to create a functional program for proof of concept. Thus, the EcoCycle program was born.

The EcoCycle program:

• Uses user profiles for personalized stats
• Has a password-protected admin page that displays a summary of total distance, total price, pedal point balance.
• Has a user summary page.
• Has a booking page allowing users to place orders for free rides.
• Displays the Carbon Dioxide offset by EcoCycle and by each individual user.
• Displays the total calories burned for each journey.
• Follows proper procedure for scalability by ensuring all def functions have their relevant #explanations and names# allowing for mass scalability if needed.
• Has the appropriate RESET protocols for use after debugging.

[!NOTE] The following parts of the program were written collaboratively with the help of large language models:

• Full Google Sheets integration with a concise graph displaying the effect of the distance on the CO2 footprint.
• Weather forecast integration.
• Travel time estimator with real-time traffic and weather conditions.

Pip Library Compatibility

We are thrilled to announce that with EcoCycle Version 2.0 , not only is this program available on the releases to download and run locally - it has just been added to the PyPI package installation library!

You can run it on your local machine with the following command: pip install ecocycle

This command will install all relevant dependencies that EcoCycle needs to run optimally, saving clients valuable time when the program is first hosted.

[!TIP] Should you want to uninstall the ecocycle pip package at any time, run this command: pip uninstall ecocycle

This command will uninstall all files that were installed by the installation command.

We suggest installing the ecocycle package from the command line to streamline your experience and to ensure that all packages run from the program are automatically updated.

We also strongly suggest all users use the latest version of EcoCycle at all times as we update many file dependencies with each release for safety.

EcoCycle's use of the Apache 2 License:

At EcoCycle, we're not just building software; we're cultivating a regenerative ecosystem of technological solutions for a sustainable future. Our choice of the Apache 2.0 license wasn't a matter of convenience – it's core to our mission. We see the Apache 2.0 license not as a restriction, but as a powerful catalyst for collaborative growth.

Contact Us

There is 1 active developer on this project: Shirish Pothi

• His contact is: [e-mail]
• Alternatively, use this link with a pre-written Gmail format to email him.

⬆ Back to Top

The EcoCycle team consists of: Shirish Pothi, Ryan Eng, Ashlesha Sahoo and Rochelle Joseph - all from Nexus International School.