Isaac

Farm & Homestead Assistant

"Isaac planted crops in that land and the same year reaped a hundredfold, because the LORD blessed him." — Genesis 26:12

A self-hosted farm and homestead management system that runs on a Raspberry Pi.
Track your plants, animals, equipment, finances, and more — all from a beautiful, touch-friendly interface.

---

At a Glance

Isaac gives you a single dashboard to manage your entire homestead. Live weather from your own station, today's tasks and schedule, frost protection alerts, feeding schedules, sun/moon data, and budget overview — all updating in real time.

Dashboard widgets include:

• Real-time weather conditions from your personal weather station
• Today's schedule with time and location badges
• Sun/moon rise and set times with civil twilight
• Animal feeding schedule
• Frost and cold protection alerts
• Budget ticker
• Daily Bible verse (optional)
• Storage health monitoring

---

What You Can Do

Manage Your Garden

Plan, plant, and track everything that grows on your property.

• Plant tracking with watering, fertilizing, pruning, and harvesting schedules
• Growth stage tracking — seed, seedling, transplanted, vegetative, flowering, fruiting, harvesting, dormant
• Photo documentation — upload multiple photos per plant
• Care logs — record every watering, feeding, pruning, and harvest
• Auto-generated reminders — Isaac creates tasks from your care schedules automatically
• Auto-watering logic — skips watering tasks when rain is detected

• Seed catalog with planting depth, spacing, germination time, and days to maturity
• Seed inventory tracking with supplier and source info

• Garden planner with frost date awareness and month-by-month planting view
• Growing season progress indicator based on your first and last frost dates
• Succession planting support with configurable intervals

• Garden bed designer — raised beds, in-ground, containers, rows, and greenhouses
• Plant placement within beds with dimensions

• Companion planting reference chart — see which plants grow well together and which to keep apart

• Garden journal — log observations over time with photos and notes
• Import plants from PFAF and Permapeople databases with one click

Frost protection:

• Isaac watches the weather forecast and tells you which plants to cover tonight
• Automated frost protection alert emails sent before temperatures drop
• Per-plant frost sensitivity tracking

---

Track Your Animals

From the family dog to the whole herd.

• Pets and livestock with health records, feeding schedules, and expense tracking
• Animal profiles — breed, birth date, weight, gender, location, photos, and notes
• Tags and labels — Sick, Injured, Pregnant, Nursing, Quarantine, For Sale, Special Diet, Senior, and more
• Care schedules for worming, vaccinations, hoof trims, dental, vet visits, and custom care types
• Care logs — record every treatment, medication, and vet visit
• Feeding schedules — feed type, frequency, quantity, and reminders
• Expense tracking — vet, medication, feed, supplies, processing costs with receipt uploads
• Cold weather alerts — Isaac checks the forecast and tells you which animals need blankets
• Livestock production — processing records with weights and cost-per-pound calculations
• Automatic reminders grouped by care type ("Worming: 3 animals due")
• Export animal data and expense reports

---

Stay On Top of Tasks

Never forget a chore, appointment, or maintenance item again.

• 8 task views: Today, Upcoming, This Week, This Month, All, Backlog, Overdue, and Metrics

• Completion metrics — track your productivity streaks and completion rates

• Calendar with day, week, and month views — auto-scrolls to current hour
• Recurring tasks — daily, weekly, monthly, or any custom interval with day-of-week selection
• CalDAV sync — bi-directional sync with iPhone and Android calendars
• Weather-dependent tasks — automatically skip when conditions are bad (rain, extreme temps)
• Task linking — attach tasks to animals, plants, vehicles, equipment, farm areas, or team members
• Task alerts — reminders at 15min, 30min, 1hr, or 2hr before due time
• Backlog — unscheduled tasks you can pull into today's schedule when ready
• Auto-generated reminders — Isaac creates tasks from plant care schedules, animal care schedules, vehicle maintenance, equipment maintenance, home maintenance, and farm area maintenance

---

Track Maintenance

Vehicles, equipment, your house, and farm infrastructure.

• Vehicles — oil changes by mileage, inspections by date, tractor service by hours
• Service records with date, mileage, cost, parts used, service provider, and photos

• Equipment — maintenance schedules for every tool and implement, tracked by date or usage hours

• Home — HVAC filters, gutters, smoke detectors, septic, roof, plumbing, appliances, and everything else

• Farm areas — fields, pastures, greenhouses, barns, fences, ponds, and other structures
• Color-coded status indicators: green (on time), yellow (due soon), red (overdue)
• Photo documentation for every maintenance record
• Cost tracking across all maintenance categories

---

Manage Your Budget

Household finances and farm business in one place.

• Budget overview with income, spending categories, and account balances

• Budget vs. actual comparison charts by month and category

• Bill tracking with due dates, payment status, and recurring bills

• Transaction management with category assignment and date tracking

• Multiple accounts — checking, savings, farm operations, travel fund, or any custom account

• Bank statement import — CSV and OFX formats with duplicate detection

• Budget settings — configure categories, accounts, and budget periods

---

Farm Finances & Production

Track what your farm produces and earns.

• Financial overview — income, expenses, and profit at a glance

• Sales tracking — record produce, livestock, and product sales
• Customer management — profiles with contact info and purchase history
• Orders and invoicing — create orders, track status (reserved, in progress, ready, completed), generate invoices
• Payment tracking — deposits, partial payments, refunds with multiple methods (cash, check, Venmo, Zelle, card)
• Invoice emailing — send invoices and receipts directly to customers
• Farm expense categories — feed, vet, processing, seeds, equipment, utilities, fuel, supplies, labor, insurance, taxes, fencing, bedding

• Homestead production — track what you grow and raise for personal use
• Livestock production — processing records with cost-per-pound calculations
• Harvest tracking — date, quantity, and yield calculations
• Production allocation — track what's sold, consumed, gifted, preserved, or lost

---

Manage Your Team

Keep your household and farm crew organized.

• Member profiles with detailed dossiers — contact info, role, bio, photos
• Team readiness assessment — see who needs training updates, medical renewals, or gear attention

• Detailed dossier per member with 10 tabs: Profile, Tasks, Gear, Supplies, Training, Medical, Mentoring, Observations, Health Data, and Fitness

• Gear inventory — track what's assigned, what's in the pool, and what needs repair
• Gear condition tracking — green (ready), yellow (needs attention), red (down)

• Supply requests — team members can request items with urgency levels and status tracking

• Weekly AAR (After Action Review) — structured team reflection for continuous improvement

Child Growth Tracking:

• Growth charts for children under 13 — weight, height, and BMI percentiles plotted against CDC curves
• Size guide — clothing and shoe size estimates with "size up soon" alerts
• Milestone tracking and advanced development detection

Health & Readiness Monitoring:

• Readiness assessment — overall score with physical breakdown (autonomic recovery, cardiovascular, immune health, activity level)
• Risk flags — automatic alerts for low scores with recommendations
• Vital tracking — weight, blood pressure, heart rate, temperature, and body measurements

Fitness Tracking:

• Fitness scoring — run, ruck, swim, bike, row, strength, HIIT, mobility, and PT test scoring
• Age and gender-adjusted standards with tier classification (elite through minimal)
• Workout logging — track every session with distance, time, weight, and reps

Training & Medical:

• Training records — certifications, skills inventory, expiration tracking
• Medical history — health records, vaccinations, dental, vision, and renewal alerts
• Mentoring sessions — log coaching conversations with outcomes and goals
• Observations — record feedback and notes on team member performance
• Daily check-in — quick vital entry, mood, energy level

---

Worker Management

Manage external workers and farm hands with multi-language support.

• Worker profiles with contact info, role, and language preference (English/Spanish)
• Task assignment — create and assign tasks to workers with priority, due date, and location
• Task status tracking — pending, in progress, completed, blocked (with reason)
• Time tracking — start/stop timers on active tasks
• Multi-language support — task instructions translated via DeepL API
• Supply requests — workers can request materials and supplies
• Visit records — log worker visits with task completion notes

---

Weather Integration

• Ambient Weather integration — real-time data from your personal weather station every 5 minutes
• NOAA fallback — if no weather station, Isaac uses National Weather Service data based on your coordinates
• Conditions tracked: temperature (indoor/outdoor), humidity, wind speed/gust/direction, barometric pressure, rain rate, UV index, solar radiation
• Weather alerts — configurable thresholds for frost, freeze, heat, wind, and heavy rain
• Frost protection emails — automatic alerts when tonight's forecast threatens your plants
• Cold protection emails — alerts when animals may need blankets or shelter
• Weather-dependent task skipping — outdoor tasks auto-skip on bad weather days
• Weather data caching — works even when internet goes down

---

AI Assistant

• Built-in chat powered by Claude, ChatGPT, or Ollama (local, free)
• Context-aware — the AI sees your garden data, animal records, weather, tasks, fitness data, budget, and production when answering questions
• Create tasks from chat — ask the AI to add a reminder and it creates a task
• AI insights — automated analysis and recommendations for garden, fitness, budget, and production
• Knowledge base — local documentation indexed for AI reference

---

Email Notifications

• Daily digest — morning email with today's tasks, weather forecast, overdue items, and alerts
• Weather alerts — frost, freeze, heat, wind, and rain warning emails
• Cold protection alerts — which plants to cover, which animals need blankets
• Task reminders — configurable timing (15min to 2hr before due)
• Team readiness alerts — gear expirations, overdue training, medical renewals
• Invoice and receipt emails — send directly to customers
• Works with Gmail, Outlook, Yahoo, ProtonMail, or any SMTP server

---

Configure Everything

• Feature toggles — enable only the modules you need (garden, animals, vehicles, equipment, home, farm areas, team, fitness, health, budget, farm finances, production, workers, AI chat, kiosk)

• Role-based permissions — Admin, Editor, Viewer, Kiosk, Farmhand, or fully custom roles with granular permission matrix

• User management — create accounts, assign roles, send invite links, set expiration dates

• Weather thresholds — set your own frost, freeze, heat, wind, and rain alert levels

• Display settings — 12h/24h time, theme selection, farm name, logo upload, Bible verse toggle

• AI configuration — choose provider, set API keys, manage knowledge base

• Calendar sync — bi-directional with iPhone/Android via CalDAV (Radicale included)
• Kiosk mode — full-screen dashboard for a dedicated barn or kitchen screen
• Setup wizard — guided first-run configuration for new installations
• Audit logging — track all changes for accountability
• Encrypted storage — API keys and sensitive settings encrypted at rest

---

Why Isaac?

Built for real homesteaders. Not a corporate farm platform. Not a spreadsheet. Isaac was built by a homesteader, for homesteaders — people who need to track when the goats need worming, whether the tomatoes will survive tonight's frost, and how much they spent on hay this month.

Runs on a Raspberry Pi. Your data stays on your property. No cloud subscriptions, no monthly fees, no one mining your farm data. Just a $50 computer on your kitchen counter.

Works offline. Isaac runs entirely on your local network. Weather data caches, tasks are stored locally, and everything works even if your internet goes down. Installable as a Progressive Web App (PWA) on any device.

Access from anywhere. When you do want remote access, set up Tailscale (free VPN) or Cloudflare Tunnel in minutes. Check on the farm from your phone while you're at the feed store.

Touch-friendly. Designed for a Pi with a touchscreen on the barn wall, a tablet in the kitchen, or your phone in the field. Big buttons, clean interface, on-screen keyboard — works with dirty hands.

Syncs with your phone. CalDAV integration means Isaac's tasks and events show up in your iPhone or Android calendar. No extra app needed.

Automates the boring stuff. Isaac generates reminders from your plant care schedules, animal care schedules, vehicle maintenance intervals, and more. It watches the weather and alerts you before frost hits. It skips outdoor watering tasks when it rains.

Speaks your workers' language. Multi-language support (English/Spanish) with automatic translation for worker task instructions.

---

Quick Start

Hardware: Raspberry Pi 4/5 (4GB+ RAM) or any Linux server

# Clone
git clone https://github.com/n0mad1k/isaac.git /opt/isaac
cd /opt/isaac

# Backend
cd backend && python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt && deactivate

# Frontend
cd ../frontend && npm install && npm run build

# Start
sudo systemctl start isaac-backend nginx

Open https://your-pi-ip and the setup wizard walks you through creating your admin account and configuring your homestead.

See the full installation guide for the complete step-by-step setup including SSL, Nginx, CalDAV, and kiosk mode.

---

Remote Access

Method	Best For	Setup Time
Tailscale	Personal/family access from anywhere	5 minutes
Cloudflare Tunnel	Public access via custom domain	15 minutes

Both options require zero port forwarding and never expose your home IP.

---

Integrations

Service	What It Does
Ambient Weather	Real-time weather from your station, automatic frost/heat/wind alerts
NOAA / NWS	Fallback forecasts when no weather station is available
CalDAV	Bi-directional calendar sync with iPhone and Android
Email (SMTP)	Daily digest, weather alerts, task reminders, invoices
AI Assistant	Farm questions answered by Claude, ChatGPT, or Ollama
PFAF / Permapeople	Import plant data from reference databases
DeepL	Automatic translation for multi-language worker support
Cloudflare Access	Edge authentication for public-facing deployments

---

Documentation

Full documentation is available in the Isaac Wiki:

• Installation Guide — Complete setup from scratch
• Remote Access — Tailscale and Cloudflare Tunnel
• Integrations — Weather, calendar, email, AI
• All Features — Everything Isaac can do
• Troubleshooting — Common issues and fixes

---

Tech Stack

Component	Technology
Backend	Python, FastAPI, SQLite, SQLAlchemy
Frontend	React 18, Vite, TailwindCSS, Recharts
Web Server	Nginx (reverse proxy + SSL)
Calendar	Radicale (CalDAV server)
AI	Claude, ChatGPT, or Ollama
Platform	Raspberry Pi 4/5, any Linux server

---

License

Commons Clause License (based on MIT). Free for personal, non-commercial use.

See LICENSE for details.

---

Support

• GitHub Issues — Bug reports and feature requests
• GitHub Wiki — Documentation

---

Made with care for farmers and homesteaders