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

💡 The idea in one breath

Most weather apps keep you scrolling. PLOT does the opposite. 📵➡️🌱

You pick a place (or share your location 📍). Real weather loads 🌦️. TabPFN, an open tabular foundation model 🧠, reads your day like a row in a frost table and answers:

⏸️ Wait · 🚶 Walk · 🌿 Garden

Then it hands you three concrete steps and expects you to leave. The screen's job is under a minute. ⏱️

🛠️ What I Built

👥 Who it's for: anyone with a yard, balcony, or park nearby who overthinks the forecast and under-leaves the house.

🎬 Demo

🎥 Screen recording: [https://www.youtube.com/watch?v=0zisIS7GLjg]

🔗 Try it yourself: plot-touch-grass.onrender.com

⏳ First load on Render free tier may take ~30s while the service wakes up.

📸 Screenshots

🏔️ Hero - PLOT landing page

🌦️ Live weather - Open-Meteo fills the form

🎯 TabPFN signal - wait / walk / garden with confidence

⚙️ How it works (60 seconds)

flowchart LR
    subgraph YOU["You"]
        A["Pick city or use location"]
    end

    subgraph DATA["Open-Meteo"]
        B["Today's temps, rain, wind, soil"]
        C["92-day frost window"]
    end

    subgraph AI["TabPFN"]
        D["Classify: wait, walk, garden"]
        E["Class probabilities"]
    end

    subgraph OUT["Outside"]
        F["3-step checklist"]
        G["Phone down"]
    end

    A --> B
    A --> C
    B --> D
    C --> D
    D --> E
    E --> F
    F --> G

🗺️ User journey

sequenceDiagram
    participant U as User
    participant UI as PLOT UI
    participant OM as Open-Meteo
    participant T as TabPFN
    participant Y as Your yard

    U->>UI: Open site / pick Portland
    UI->>OM: GET /api/weather
    OM-->>UI: Real temps, frost lag, soil
    U->>UI: Get outdoor signal
    UI->>T: POST /api/check
    T-->>UI: garden, 83% confidence
    UI-->>U: Checklist (3 steps)
    U->>Y: Goes outside

🏗️ Architecture

graph TB
    subgraph Client["Browser"]
        WEB["Static UI / web"]
    end

    subgraph RenderHost["Render - plot-touch-grass"]
        API["FastAPI / backend/main.py"]
        ENG["OutdoorEngine / TabPFNClassifier"]
        CSV[("outdoor_history.csv - 30684 ERA5 rows")]
        WX["weather.py - Open-Meteo + fallback"]
    end

    subgraph External["Open services"]
        OM["Open-Meteo API"]
        TP["Prior Labs TabPFN"]
    end

    WEB -->|/api/weather| API
    WEB -->|/api/check| API
    API --> WX
    WX --> OM
    API --> ENG
    ENG --> CSV
    ENG --> TP

📈 The data story (real, not synthetic)

This is the part I cared about most. No fake temperatures. ✅

flowchart TD
    A["Open-Meteo Historical API - ERA5"] --> B["scripts/fetch_real_data.py"]
    B --> C["12 cities x 7 years of daily rows"]
    C --> D["Feature engineering"]
    D --> D1["days_since_last_frost from min temp at 0C"]
    D --> D2["soil_moisture, wind, daylight"]
    D --> E["Labels via backend/labels.py"]
    E --> F["outdoor_history.csv - 30684 rows"]
    F --> G["TabPFN fit and predict"]

🌎 Cities in the training set

📊 Label distribution (on real weather)

Labels come from transparent horticulture heuristics in backend/labels.py (frost-free days, precip, wind bounds). TabPFN learns patterns in the table, not chat prose. I'm upfront about that. 📝

🔨 How I Built It

1️⃣ Real training pipeline

python scripts/fetch_real_data.py

Pulls daily ERA5 weather from Open-Meteo for every city above. Regeneratable. Documented in data/DATA_SOURCES.md.

2️⃣ TabPFN as the classifier

from tabpfn_client import TabPFNClassifier

model = TabPFNClassifier()
model.fit(X_train, y_train)           # real rows
proba = model.predict_proba(X_today)  # wait / walk / garden

Open-weight tabular model. Swap it without rewriting the product. 🔁

3️⃣ Live weather endpoint

GET /api/weather?lat=&lon= returns today's conditions + frost lag.

• 🌐 Primary: Open-Meteo forecast with past_days=92 for frost history
• 🛡️ Fallback: nearest city's real ERA5 row for today's calendar day (when API rate-limits on free hosting)

4️⃣ UI that stays out of the way

No chat bubble. No purple gradients. One brand (PLOT), one CTA, one result card. ✨

• 🏙️ City presets across 12 climates
• 📍 Use my location (browser geolocation)
• 🔄 Refresh live weather
• ✅ Checklist that ends at the door

5️⃣ Deployed on Render

render.yaml blueprint, health check at /api/healthz, TABPFN_TOKEN in env (never committed). 🔒

💻 Code

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env   # set TABPFN_TOKEN
PYTHONPATH=. uvicorn backend.main:app --reload --host 127.0.0.1 --port

plot/
├── backend/
│   ├── engine.py      # TabPFN + transparent baseline
│   ├── weather.py     # Open-Meteo live + ERA5 fallback
│   ├── labels.py      # Documented outdoor-action heuristics
│   └── main.py        # FastAPI routes
├── data/
│   └── outdoor_history.csv   # 30,684 real ERA5 rows
├── scripts/
│   └── fetch_real_data.py
└── web/               # Static UI

🔓 Why Does Open Innovation Matter?

Frost and planting decisions are tabular 📋. They belong in a spreadsheet, not a chat thread. 💬❌

🔐 Privacy: we don't store your location. Weather is fetched per request. Training table ships with the repo and is auditable.

🏕️ Offline path: the CSV + open model path means this could run on a laptop in the backcountry with cached rows. That's the Touch Grass future I want.

A closed chat API wouldn't know what to do with days_since_last_frost: 208. TabPFN was built for exactly that column. 🎯

🏆 What I'd tell judges

🤖 My Agent Session

Built with TabPFN docs + Open-Meteo API. Happy to answer questions in the comments. 💬

🎁 Prize Categories

• 🧠 Best Use of TabPFN - core classifier on real frost/weather tables
• ☁️ Best Use of Render - production deploy at plot-touch-grass.onrender.com

🔗 Links

Thanks for reading. Now go touch some grass. 🌿👋