🌿 NatureQuest AI: Turn Screen Time into Green Time

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

What I Built

Modern life is dominated by screens, notifications, and endless indoor scrolling. NatureQuest AI is an open-source, full-stack wellness and exploration platform designed to get people off their desks and into the real world.

It turns outdoor exploration into an interactive adventure by:

AI Outdoor Quest Generator: Creates context-aware, bite-sized outdoor quests (5–60 minutes) tailored to user surroundings (parks, gardens, neighborhood sidewalks, backyards) and activities (walking, birdwatching, mindful sensory observation, nature photography, litter cleanups).
AI Nature Vision & Explorer: An instant field identification tool. Snap or upload a photo of a leaf, wildflower, mushroom, or bird during a walk to identify its scientific name, ecological importance, and fun facts.
Field Nature Journal: A personal digital herbarium and field notebook to log outdoor observations, thoughts, and photos.
Gamified Habits: Level up with outdoor XP, maintain daily streaks, view weekly outdoor activity charts, and unlock achievement badges.
Who it's for: Remote workers battling screen fatigue, nature enthusiasts, families, and anyone who needs a fun, positive nudge to step outside, breathe fresh air, and cultivate a daily nature habit.

Demo

🌐 Live Application: https://naturequest-ai.vercel.app/
💻 Backend API & Swagger Docs: Available locally and containerized via Docker Compose.

Code

The entire project is 100% open-source under the MIT License on GitHub:

W47K3RJO1N / naturequest-ai

NatureQuest AI 🌿 — Touch Grass Daily

An open-source, full-stack AI-powered outdoor adventure web application built for the "Touch Grass" theme.

NatureQuest AI turns screen fatigue into mindful nature habits. It generates personalized outdoor micro-quests using Google Gemini, identifies plants and wildlife through multimodal AI vision, records observations in a personal Nature Journal, and gamifies outdoor consistency with levels, badges, and streaks.

---

🌟 Key Features

1. AI Quest Generator:

   • Tailored outdoor challenges based on duration (5 to 60 mins), difficulty, activity (Walking, Plant Observation, Bird Watching, Photography, Mindfulness, Litter Cleanup), and setting (Park, Garden, Backyard, Neighborhood).
   • Generates actionable tasks, safety reminders, and XP rewards.
   • Powered by official Google Gen AI SDK with structured Pydantic validation and curated offline fallback quests.
   • Zero-footprint Leave No Trace ethics (never encourages foraging toxic species, trespassing, or disturbing habitats).

2. Nature Explorer & Flora Identification:

   • Upload or snap photos of plants, leaves…

View on GitHub

Tech Stack:

Frontend: Next.js 14 (App Router), React, Tailwind CSS, Lucide Icons, Recharts
Backend: FastAPI (Python 3.10+), SQLAlchemy, Pydantic v2, PostgreSQL / SQLite
AI Engine: Google Gen AI SDK (google-genai), Gemini 2.5 Flash / multimodal vision

How I Built It

Structured Micro-Quest Generation: The backend prompts the model using structured Pydantic schema validation (QuestStructuredOutput). It injects environmental parameters, duration, Leave No Trace safety ethics, and localized constraints to produce actionable steps, safety warnings, and XP allocations without hallucinated or hazardous activities (e.g., forbidding ingestion of wild mushrooms/plants).
Multimodal Field Vision: In the Nature Explorer module, images are processed with multimodal vision to extract taxonomic details (common & scientific names, category, confidence score, and environmental roles).
Resilient Offline Fallback Architecture: To ensure privacy, offline accessibility on remote trails, and zero-downtime evaluation, NatureQuest AI features an integrated fallback engine. If connectivity or API keys are unavailable, it smoothly defaults to curated naturalist micro-quests and built-in ecological records.
Full-Stack Monorepo: Dockerized with Docker Compose for seamless single-command local development.

Why Does Open Innovation Matter?

When building tools meant to reconnect humanity with the natural world, open innovation is vital:

Transparency & Safety: Outdoor applications must adhere strictly to environmental safety and "Leave No Trace" ethics. Open-source code allows naturalists, educators, and the community to audit prompt behavior and ensure the AI never recommends harmful foraging, trespassing, or disturbing fragile wildlife habitats.
Community-Driven Biodiversity: Nature belongs to everyone. Open models and open code empower global contributors to adapt the app for regional ecosystems, indigenous plant knowledge, and local parks without relying on a closed, black-box ecosystem.
Data Privacy & Portability: Users exploring their neighborhoods shouldn't have their location habits locked into closed proprietary silos. With NatureQuest AI, users can self-host, run local offline fallbacks, and export their field journal data whenever they choose.

My Agent Session

During the development of NatureQuest AI, I used an AI pair-programming agent to accelerate our full-stack architecture and outdoor-first mechanics:

• Prompt Engineering & Structured Schemas: Iterated on Pydantic validation schemas with Google GenAI SDK to guarantee consistent JSON outputs for quests and botany classification.
• Fail-Safe Offline Design: Designed and implemented the fallback naturalist engine to ensure users without active internet on trails or valid API keys still get rich, curated micro-quests.
• Gamification Mechanics: Formulated and balanced the non-linear XP curve (Level N = 100 * (N - 1)^1.5 XP) along with automated test suites verifying anti-duplication reward checks.
• Leave No Trace Safety Constraints: Crafted negative safety constraints in the agent prompt harness to explicitly prevent dangerous wild plant ingestion, toxic mushroom foraging, or habitat disruption.