Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass

Touch Grass (NatureQuest 🌱) is an open-source AI platform built around a single foundational principle:

"Plan on the screen. Experience it in the real world."

Most digital applications attempt to maximize screen time, trapping users in engagement loops. Touch Grass does the exact opposite: it uses open-source AI to help people disconnect from their screens, step outside, and reconnect with nature through personalized real-world missions.

🧭 AI Outdoor Adventure Planner (Feature B)

🎯 Nature Missions & Challenges (Feature C)

https://github.com/your-username/touch-grass Enter fullscreen mode Exit fullscreen mode Technology Stack Frontend Framework: React 19 & Vite 6 Styling: Tailwind CSS v4 CLI with custom nature design tokens (forest green, moss, cream, sand) Icons & Micro-animations: Lucide React & Canvas Confetti Routing: React Router DOM v7 Data Storage: Local browser storage ( localStorage ) with JSON export/import How I Built It I designed a modular AI Service Module ( src/services/aiService.js ) separate from React UI components:

┌─────────────────────────────────────────┐ │ Touch Grass AI Service │ └────────────────────┬────────────────────┘ │ ┌──────────────────────────┼──────────────────────────┐ ▼ ▼ ▼ ┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐ │ Local Ollama │ │ Open-Weight API │ │ Offline Nature Engine │ │ (http://localhost:11434) │ │ (OpenAI-Compatible) │ │(Deterministic Fallback)│ └───────────────────────┘ └───────────────────────┘ └───────────────────────┘ Enter fullscreen mode Exit fullscreen mode Local Ollama Inference: Connects directly to a local Ollama server running open-weight models ( llama3.2, gemma2, phi3, mistral ). Runs 100% locally on the user's laptop without sending data to external servers. Open-Weight Remote API: Connects to open inference endpoints supporting open-weight models.

Deterministic Rule-Based Fallback Engine: A rich offline generator that creates tailored, structured adventure plans and guide responses instantly when internet or local model endpoints are unavailable. Source Attribution & Safety: Every generated plan displays latency metadata and model disclosure notices. Built-in safety guardrails: explicit warning against eating wild plants/mushrooms based solely on AI responses, plus Leave No Trace and wildlife distance rules.

Why Does Open Innovation Matter? Open innovation and open-source AI are fundamental to building ethical technology that respects human attention and real-world well-being:

Plan on the screen. Experience it in the real world. 🌿