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

Upload your images in the DEV editor and replace the placeholders below.

🏔️ 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 Cursor + 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. 🌿👋