Skip to content
seedypodPublic

About

Local, cloud-free control for Gardyn hydroponic towers — Rust HAL, tRPC/REST/MCP server, web UI, Home Assistant

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

752 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

seedypod

Your garden, your rules. seedypod replaces the Gardyn cloud with software on the tower's own Raspberry Pi: light, water, sensors and cameras on your network, Autopilot and camera growth analysis, an MCP server so AI agents can plan your pods, and HomeKit and Home Assistant built in.

CI HAL (Rust) codecov Release License: AGPL v3 Docs Live demo

Live demo · Get started · User guide · iPhone app · Developer docs · Issues

The seedypod web UI's Home screen: the tower in 3D under its lit grow light, on day 19 of a grow with 19 pods ready to harvest (demo data)

A Gardyn has a Raspberry Pi inside and a cloud subscription in front of it. seedypod replaces the cloud with software that runs on that Pi. There's no account and no telemetry, and nothing leaves your LAN unless you turn it on. It's a sibling of sleepypod.

No Gardyn? Try the live demo. It runs the real web UI against a simulated tower in your browser.

How it works

Part What it does
hald (Rust) Owns the pins and buses: the light, pump, sensors, cameras and button. A safety guard checks every pump and dose command. It publishes over MQTT with Home Assistant discovery.
core (TypeScript) Runs scheduling, grow cycles, Autopilot rules, camera analysis and alerts. It serves a React web UI, a tRPC/REST API and an MCP endpoint for AI agents.

Features

  • Light and water: Auto light that follows the sun, with its hours from the grow protocol, or light curves of your own; watering that follows the grow protocol's stages, or one of your own schedules. A change on the Light page holds the light until the curve's next change, for an hour, or until you resume.
  • Autopilot: WHEN/IF/THEN rules over live readings. Rules run as dry-runs until you arm them, and a backtest shows what one would have done.
  • Grow tracking: grow cycles with reminders, the tower in 3D (pods colored by status and sized by measured growth, the tank's water level, the light bars at their level) or as a table, and camera captures with per-pod growth trends.
  • Probes: add pH, EC and water-temperature probes from the app, with guided calibration.
  • Integrations: Home Assistant over MQTT, MCP for agents, optional capture mirroring to S3-compatible storage, and dataset export.
  • iPhone app: the tower in 3D, pod cards, light, water and alerts, from seedypod/ios. It finds core over Bonjour; see the app's docs.
  • Wi-Fi setup: hold the button for 10 seconds to start a setup hotspot.
  • SD card care: logs and swap stay in RAM, a meter shows the card's writes per day, and nightly backups go to your bucket. A dead card is a reflash plus Welcome → Restore from a backup.

Status: running on a real Gardyn 3.0 (Pi Zero W) since 2026-11-06. Verified on that unit: both installers and seedypod OS, the grow light, the sensors, both cameras with image analysis, HomeKit pairing and the web UI. Not yet verified, because its tank is still empty: a pump run and the water-level reading against water. The cameras' USB hub still comes up on only some boots. See the bring-up notes and the hardware map.

Install

Back up the stock microSD card first, then follow docs/INSTALLATION.md. The quickest way is to flash seedypod OS, which has everything on it. On a fresh Raspberry Pi OS Lite, or to update, install the hardware daemon, then core:

curl -fsSL https://raw.githubusercontent.com/seedypod/core/main/scripts/install-hal | bash
curl -fsSL https://raw.githubusercontent.com/seedypod/core/main/scripts/install | bash

Both run on the original Pi Zero W that Gardyn ships and on a Pi Zero 2 W. Core prefers Node 24, which needs a 64-bit OS; on a 32-bit Pi, such as the Zero W, the installer uses Node 22 instead. Node 22 gets security fixes until April 2027, so a Zero 2 W (about $15, a drop-in swap) on 64-bit Raspberry Pi OS is the long-term setup. scripts/install --check says which Node a machine gets; Which Pi has the details.

Development

No hardware is needed. pnpm dev runs core against a simulated HAL. Use the Node in .node-version (24); CI also tests on Node 22, the version 32-bit Pis run, so keep to APIs both have.

The logo and icon PNGs under web/public/brand/ are stored with Git LFS. Install it before you clone, or the images check out as small text pointer files and the app shows broken logos. A unit doesn't need LFS: scripts/install downloads a tarball that CI builds with the images in it.

brew install git-lfs     # or your package manager
git lfs install          # once per machine
git lfs pull             # in a clone made without LFS
pnpm install
pnpm dev                 # core on :3000, web on :5173
API_TARGET=http://seedypod.local:3000 pnpm dev:web   # the web UI against a real unit
API_TARGET=http://seedypod.local:3000 API_KEY=… pnpm dev:web   # … one with an API key (sent by the dev proxy, never bundled)
pnpm test                # Vitest
pnpm hal:test            # cargo test
pnpm lint && pnpm tsc

The REST spec is at http://localhost:3000/api/openapi.json, and the MCP endpoint is POST /api/mcp.

Contributing

dev is the integration branch, and main is release-only. Use conventional commits. A PR into main cuts a release, so its title must start with feat:, fix:, perf: or revert:. Read AGENTS.md and the ADRs before changing hardware, safety or schema code.

License

AGPL-3.0.

seedypod is a clean-room implementation and uses no code from iot-root/garden-of-eden (GPL-3). That project's pin map and bug history were invaluable references and are credited in docs/hardware/pin-map.md.

About

Local, cloud-free control for Gardyn hydroponic towers — Rust HAL, tRPC/REST/MCP server, web UI, Home Assistant

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages