DEV Community

Aditi Patel
Aditi Patel

Posted on

Touch-Grass

#devchallenge #hf26challenge

🌱 Touch-Grass AI — Your Digital Detox Companion

Touch Grass. Touch Life. Feel Better. 🌿

🔗 Live Demo: touchgrass-ai.streamlit.app

TouchGrass AI is a fun, interactive web application designed to encourage people to take a break from their screens, spend more time outdoors, build healthy daily habits, and reconnect with the real world.

Instead of endlessly scrolling, turn your outdoor time into an adventure! Complete daily missions, track your progress, and make every day a little greener. 🌍

✨ Features

  • 🏡 Daily Missions — Discover fun activities that encourage you to step outside.
  • 🎮 Play Together — Explore interactive activities and challenges.
  • 🎯 Daily Goals — Set outdoor time targets and work toward healthier habits.
  • 📊 My Journey — Track your progress with interactive checklists and a 100-point scoring system.
  • 🗺️ Adventure Planner — Get ideas for outdoor activities and plan your next adventure.
  • 🌿 Fun & Interactive UI — Enjoy a colorful, beginner-friendly experience.
  • 📥 Download Your Plan — Save your outdoor adventure plan for later.

🎯 Why TouchGrass AI?

Spending too much time in front of screens can make it easy to forget the world outside. TouchGrass AI encourages small, achievable steps toward a more balanced digital lifestyle.

Whether it's taking a short walk, enjoying nature, or spending time with friends, every little step counts!

🛠️ Tech Stack

  • Python — Application logic
  • Streamlit — Interactive web interface
  • ollama
  • cloud code
  • Git & GitHub — Version control and collaboration

🚀 Run Locally

Want to run TouchGrass AI on your own machine?

1. Clone the repository 

git clone https://github.com/gurjaraditipatel-blip/touchgrass-ai.git
cd touchgrass-ai
Enter fullscreen mode Exit fullscreen mode

2. Create a virtual environment 

python -m venv .venv
Enter fullscreen mode Exit fullscreen mode

3. Activate the environment

Windows PowerShell:

.venv\Scripts\Activate.ps1
Enter fullscreen mode Exit fullscreen mode

macOS / Linux:

source .venv/bin/activate
Enter fullscreen mode Exit fullscreen mode

4. Install dependencies 

pip install -r requirements.txt
Enter fullscreen mode Exit fullscreen mode

5. Run the application 

streamlit run app.py
Enter fullscreen mode Exit fullscreen mode

The app will open in your browser, usually at http://localhost:8501.

📸 Screenshots

Screenshots of the application can be added here to showcase the interface.

TouchGrass AI Home

🌍 Hacktoberfest & Contributions

Contributions are welcome! 💚

If you'd like to improve TouchGrass AI, you can help by:

  • 🐛 Fixing bugs and improving existing features.
  • 🎨 Enhancing the UI and user experience.
  • 🌱 Adding new outdoor challenges and daily missions.
  • 📈 Improving progress tracking and goal-setting features.
  • 📚 Improving documentation.
  • ♿ Making the app more accessible.
  • 🧪 Adding tests and improving code quality.

💡 Future Improvements

  • 💾 Persistent user progress and saved goals.
  • 🏆 Badges, streaks, and achievement tracking.
  • 🌤️ Weather-aware outdoor activity suggestions.
  • 👥 More multiplayer challenges.
  • 📱 Improved mobile experience.
  • 🤖 Optional AI-powered personalized activity recommendations.

🔒 Privacy & Data

TouchGrass AI is designed to be simple and accessible. The current version uses in-app logic for its activities and scoring. Progress may not persist after a session or app restart.

Avoid entering sensitive personal information into the app.

💚 Our Mission

We believe technology should help us live better—not keep us glued to our screens.

Take a break. Step outside. Touch grass. 🌱

Made with 💚 for a healthier digital lifestyle.

⭐ If you like this project, consider giving it a star on GitHub!

🔗 Try it now: TouchGrass AI — Live App

Top comments (0)