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

What I Built

🌿Alt-nature: An AI-Powered Micro-Quest Platform for Screen-Free Breaks

We spend our lives staring at glowing rectangles, waiting for digital fatigue to burn us out. We know we need to step away, but walks feel aimless. Alt-nature solves this by turning the real world into an interactive, AI-driven adventure without forcing you to stare at your phone while you do it.

When you type in your location and pick an outdoor vibe like a Fall Foliage Walk or Forest Trail, the app fetches real-time local weather via SerpAPI, generates a personalized sensory quest using an open-weight Gemma model, crafts immersive environmental lore, and synthesizes a voice-guided mindfulness briefing using ElevenLabs TTS. Once you step outside, complete your walk, and return, you can log your reflection directly back into the platform, which stores your completed milestones in MongoDB Atlas.

Demo

• GitHub Repository:

  dataWizard7957 / Alt-nature

  Alt-nature 🌿

  Alt-nature is an open-source AI agent system designed to drag software engineers away from their screens and into nature. By combining open-weight model inference with environmental grounding , speech synthesis , and durable persistence , Alt-nature delivers screen-free outdoor audio quests.

  Real outdoor exploration happens where cell reception dies. By leveraging open-weight models like Gemma, Alt-nature guarantees zero latency, absolute privacy for real-time outdoor locations, and complete independence from closed proprietary APIs. You get full control over your prompt pipelines and system guardrails without vendor lock-in.

  ---

  🛠️ Tech Stack

  • Core AI Model: Gemma (open-weight model for dynamic quest generation)
  • Voice Narration: ElevenLabs API (for hands-free, screen-free audio briefings)
  • Data & Persistence: MongoDB Atlas (for storing active quests, reflections, and user history)
  • Environmental Grounding: SerpAPI (for real-time weather and seasonal status)
  • Agent Observability: Sentry Agent Tracing (tracking execution telemetry, routing, and inference fallbacks)

  ---

  ⚙️ Quickstart

  1. Clone and Setup…

  
  

  
  

  View on GitHub

  
  
• Screen recording:

Code

The project is split into a robust FastAPI backend and an interactive Streamlit frontend. Here is a look at the repository layout:

Alt-nature/
├── app/
│   ├── core/         # Database and configuration
│   ├── models/       # Pydantic validation schemas
│   ├── routers/      # API endpoints (quests generation & verification)
│   └── services/     # Gemma, SerpAPI, and ElevenLabs integrations
├── frontend/         # Streamlit UI application
└── static/           # Audio narration storage

How I Built It

Alt-nature relies on a modern, modular AI engineering tech stack:

• Backend: FastAPI with Pydantic schema validation and asynchronous routing.
• Database: MongoDB Atlas for securely tracking active and completed user quests and reflections.
• AI & Generation: Gemma (open-weight model) for dynamic quest generation with local fallback support.
• Environmental Context: SerpAPI to pull live local weather data and tailor quest objectives to current conditions.
• Voice & Audio: ElevenLabs TTS API to synthesize immersive, calming audio briefings for screen-free guidance.
• Frontend: Streamlit for rapid UI prototyping with custom emoji-coded themes and responsive audio players.

Why Does Open Innovation Matter?

Open innovation specifically leveraging open-weight models like Gemma was foundational to building Alt-nature. Closed, proprietary APIs often impose rigid constraints and strict rate limits that make real-time sensory prompt engineering and localized environmental blending difficult to customize. Open-weight models gave me the flexibility to fine-tune system prompts for mindfulness, run local test inferences during development, and build deterministic system guardrails without vendor lock-in.

Prize Categories

• Open-Source AI Challenge (Week 1: Touch Grass)
• Best Use of ElevenLabs: Alt-nature leverages ElevenLabs TTS to convert generated environmental lore into calming, screen-free voice briefings for outdoor walks.
• Best Use of MongoDB Atlas: MongoDB Atlas securely manages persistent state tracking for active quests, user reflections, and completion statuses.
• SerpAPI: SerpAPI fetches live local weather data to dynamically tailor micro-quest objectives to real-world environmental conditions.
• Sentry: Sentry provides real-time error monitoring and agent tracing across backend FastAPI routing and inference fallbacks.

Comments

[DEV SUPPORTS]

You need to verify your account.

tr.ee/dev-to