HelloAG AgOS · User Manual · June 2026 · 56 Files
Complete User Manual · Updated June 2026
HelloAG AgOS —
All Pillars. All Modules.
One Reference.
This manual covers every page and module in the HelloAG platform — the institutional website (13 pages), the four intelligence pillars (12 dashboards), all 15 operator modules, and the two data tools (CRM and Ask the Data). 56 files. 28 clean URL routes. Updated for the June 2026 deployment.
Getting Started
How to Navigate
HelloAG.
The platform has two distinct layers. The institutional website (public-facing, starts at helloagriculture.com) is for stakeholders, researchers, government, and institutional visitors. The platform layer (starts at /platform) is for operators — farmers, field agents, hotel buyers, and analysts.
Start at helloagriculture.com to see the institutional homepage. Navigate to helloagriculture.com/platform to enter the operator dashboard with the four-pillar persona selector.
Once inside the platform, use the topbar navigation links — every module has ← Platform and 📊 Intelligence links in its topbar, so you are never more than one click from any other module. The sidebar on the left (in modules that have one) shows all sub-sections of the current module.
Institutional Website
The Institutional
Website Layer.
Thirteen pages form the public-facing institutional website. These pages are for governments, development banks, research institutions, hotel groups, and journalists — not operators. The entry point is the homepage at helloagriculture.com/.
Entry Points & Core Pages
The primary entry point. "The Operating System for Food Security" hero. Problem section, platform preview, who-we-serve grid, proof metrics, research teaser, consulting CTA. First impression for PM, IFC, JHTA visitors.
The origin story. Mile Gully → BonnyGate → Cornell → Jamaica deployment. Founder bio, vision, mission, institutional relationships, CADE Group Inc., Project TEA-RED future.
📚
Research Library
/research
Three research collections: Stakeholder Intelligence Series (5 volumes), HelloAG OS Architecture, Project TEA-RED. Lead capture modal per paper. Download gate feeds the CRM via BroadcastChannel.
Three service tiers (Government Advisory, Platform Deployment, Research). Four-phase engagement model. Contact form. Submissions broadcast to CRM automatically via BroadcastChannel.
⚙️
HelloAG OS Explainer
/helloag-os
Non-technical platform explainer. Four-pillar tabbed architecture. "Not an app — an operating system" distinction block. Three access paths: farmer, government, hotel buyer.
🧠
Stakeholder Intelligence
/stakeholder-intelligence
Concept page for the category. Five stakeholder types, five information gaps, intelligence loop diagram. Links to research library. Most important conceptual positioning page.
Solutions Pages (5 pages)
/solutions/government
Government & Policy
Six platform capabilities, Digital Twin callout, four-part partnership model, the four government asks.
/solutions/tourism
Tourism & Hospitality
TAII four-step workflow, commodity availability table, hotel procurement benefits, link to live portal.
/solutions/finance
Finance & Development
ABRS credit underwriting, portfolio intelligence, country food security assessments for development banks.
/solutions/agribusiness
Agribusiness & Export
Price intelligence, GIS supply chain design, JAMPRO export pathway via ABRS Grade A.
/solutions/development
Development Agencies
UN agencies, bilateral donors, NGOs. Country profiles, M&E infrastructure, Digital Twin for programme design.
/project-tea-red
Project TEA-RED
TEA-RED three pillars, five focus areas, CARICOM rollout model with 11 member states. CADE Group Inc. vehicle.
The consulting form and research download modal both automatically send new contact data to the CRM. Open /crm in another tab to see inbound leads appear within 3 seconds of a form submission. No manual data entry required.
Pillar 1 · Intelligence
Intelligence
Dashboards.
The Intelligence pillar provides national food security visibility for government policy makers, analysts, and institutional stakeholders. All seven dashboards use live AMIB data updated weekly. All are accessible at the URLs shown.
⬡
National Command Center
/command
Bloomberg-style food security situation room. Live KPIs, alert ticker, parish risk map, all Intelligence feeds in one view. Primary government demo screen.
Key elements
Top KPI row — FSI, CVI, active alerts, total records
Alert ticker — real-time Sentinel broadcasts
Parish risk heat map — colour-coded FSI by parish
Commodity price feeds — 12 tracked commodities
Jamaica's first real-time national FSI. Four components (price stability, supply availability, food access, climate risk). Parish-level breakdown for all 14 parishes. National score: 74.2.
How to read it
Score 0–100: 80+ excellent · 70–79 stable · 60–69 stressed · below 60 critical
The four component bars show which factor is dragging the overall score
Parish table — click any parish for detailed breakdown
12-week trend — shows trajectory, not just current state
⚡
Digital Twin Simulator
/twin
Eight disaster scenarios — Hurricane, Drought, Flooding, Tourism Surge, Import Disruption, Disease Outbreak, Fertilizer Shortage, Transport Disruption. Real economic loss calculations from live data.
How to run a simulation
Select scenario from the left panel
Set intensity (1–5), duration, and season
Click Run Simulation — results compute in under 2 seconds
FSI drop, production loss (kg + J$M), parish risk levels appear
📈
Commodity Volatility Index
/cvi
Price instability ranking across 12 commodity categories. CVI 31 — Elevated. Thyme and Scotch Bonnet driving 62% of national volatility. 8 days ahead of retail market signals.
CVI above 25: Elevated — government action may be needed
Individual commodity scores on right panel — click for price history
Thyme 78 · Scotch Bonnet 65 · all others below 40
US$840M annual food import bill tracked, dissected by commodity. US$310M substitution opportunity. J$29B five-year forex retention model with baseline, moderate, and accelerated scenarios.
Top waterfall chart — total import bill by commodity category
Substitution slider — model different local sourcing % scenarios
Forex retention chart — cumulative J$ retained over 5 years
🌾
JAIS Production Intelligence
/jais
Jamaica's national harvest calendar, agro-ecological zone classification, production cluster mapping. The production intelligence layer that sits under the FSI.
8 agro-ecological zones — each with capacity and utilisation estimate
Harvest calendar — 12 commodities, planting / peak / harvest by month
34% underutilised capacity identified across primary zones
Pillar 2 · Connect
Connect & TAII
Modules.
The Connect pillar handles the transaction layer — linking hotel procurement to verified local farmers, managing marketplace orders, processing payments, and tracking deliveries. Primary users: hotel F&B procurement officers, agribusiness buyers, and verified ABRS-enrolled farmers.
Ten-panel TAII Tourism Agricultural Intelligence Infrastructure. Overview, supply gaps, tourism assets, demand forecasts, planting calendar, climate risk, disaster prep, import substitution, parish tiers, TAII map.
Navigation
10 subnav tabs across the top — click to switch panels
Overview panel: FSI, gap severity, asset map, action items
Supply Gaps: commodity gap table by parish and severity
Parish Tiers: four-tier hotel supply readiness classification
Point-of-sale for farm gate, market, and delivery transactions. GS1-traceable records. Connects to the dispatch module for fulfilment confirmation.
Select buyer and commodity — enter quantity and unit price
Generate GS1 transaction record — both parties receive confirmation
Transaction auto-logs to the delivery dispatch queue
🚚
Delivery & Dispatch
/dispatch
Route management, temperature logging, delivery confirmation, status notifications. Tracks every order from farm gate to hotel kitchen with GS1-standard traceability documentation.
Active orders list — status: Pending / In Transit / Delivered
Update delivery status — triggers notification to buyer
Temperature log entry — records cold chain integrity
📦
Inventory Management
/inventory
Farm inventory — current stock, harvest dates, produce category, quality grade. Links to the marketplace for available-to-sell listings and the POS for stock deductions.
Add stock — commodity, quantity, harvest date, quality grade
Mark available to sell — pushes to TAII marketplace
Stock auto-reduces when POS transaction recorded
Pillar 3 · Sentinel
Sentinel & Farmer
Registry Modules.
Sentinel is the enrolment and early warning layer. Every enrolled farmer receives a HAG-ID and ABRS creditworthiness score. Government sees aggregate enrolment and early warning data. Banks see ABRS scores. Extension agents manage the registration pipeline.
National and parish ABRS averages. Grade distribution (A through D). Improvement trends. Credit threshold tracking. National average: 62. St. Mary pilot: 74 (Grade A).
National ABRS gauge — current national average across enrolled farmers
Grade distribution chart — A (70+), B (60–69), C (50–59), D (below 50)
Parish leaderboard — top-performing parishes by average ABRS
Credit threshold line — Grade A (70) = bank-eligible
🌱
Farmer Self-Registration
/register
Mobile-first six-step farmer enrolment. Personal details → Enterprise selection → Production reporting → GPS farm boundary → ABRS self-assessment → Review and submit. HAG-ID generated on completion.
Six steps
Step 1–2: Identity and enterprise type (16 types)
Step 3: What is currently in ground, expected harvest, volume
Step 4: GPS farm boundary — browser geolocation + polygon draw
Step 5: 20-question ABRS self-assessment — live score calculation
Step 6: Review and submit — HAG-ID generated, emitted to DataBridge
🔔
Sentinel Alert System
/notifications
Pest outbreak, price emergency, and climate alerts broadcast to enrolled farmers in affected parishes. Extension agents create and target alerts by commodity and parish. Three active alerts current.
Active alerts: Thyme (critical), Scotch Bonnet (critical), Cho Cho (watch)
Create alert — select type, severity, parish target, message
Broadcast — sends to all enrolled farmers in targeted parishes
🛡️
Sentinel Simulation
/simulation
Test Sentinel broadcast scenarios against the registered farmer network before going live. Model alert reach, coverage gaps, and parish penetration rates.
Set scenario type and target parishes
Run simulation — shows % of farmers reached, coverage gaps
Identify under-enrolled parishes needing registration drives
Pillar 4 · Insights
Insights & Data
Intelligence Modules.
The Insights pillar surfaces the analytical power of 186,000+ AMIB price records through structured query tools, commodity forecasts, volatility indices, and AI-generated recommendations. Primary users: extension agents, market analysts, data-driven farmers.
📊
Market Intelligence
/insights
AMIB price table — 12 commodities, weekly data, category filter. Current prices, week-on-week change, 4-week and 13-week trend indicators. Auto-refreshes from Supabase on load.
Filter by category (herbs, roots, vegetables)
Click any commodity for 13-week price history chart
WoW change column — red (rising) / green (falling) / grey (flat)
Structured query interface against 186,000+ AMIB price records. Four query types: Price Trend, Price Comparison, Volatility Analysis, Market Overview. Five quick-query presets. CSV export.
Four query types
Price Trend — single commodity over 4/13/26/52 weeks
Price Comparison — up to 4 commodities on one chart
Volatility Analysis — all commodities ranked by price instability (CV%)
Market Overview — all commodities, current week snapshot (auto-loads)
🔮
Yield Forecasting
/forecast
90-day statistical price forecasting for 12 commodities. EMA smoothing + seasonal adjustment + linear slope. ±1.5σ confidence bands. Directional accuracy 70–75%.
Select commodity from left panel
Chart shows 26 weeks historical + 13 weeks forecast
Shaded band = confidence interval — narrower = more certain
Seasonal factor indicator — shows if harvest season is affecting forecast
Commodity Opportunity and Profitability Index — four enterprise types, cost/revenue/margin calculations. Helps farmers and extension agents identify most profitable enterprise combinations for a given parish.
Select enterprise type and parish
Enter production costs — COPI calculates margin and opportunity score
Compare across enterprises — colour-coded profitability ranking
Platform Tools
CRM & GIS
Tools.
Two cross-pillar tools that support the institutional and operational functions of the platform.
Salesforce-concept CRM for managing institutional relationships. 12 seed contacts from the HelloAG institutional network. Three views: Dashboard, Contacts table, Pipeline Kanban. CSV import and BroadcastChannel lead receiver.
Key features
Dashboard: KPI cards (total, leads, engaged, partners), pipeline chart, activity feed
Contacts: searchable table — filter by type, stage, country
Pipeline: Kanban board — New Lead → Qualified → Engaged → Proposal → Partner
Click any contact → detail panel opens on right with full timeline
CSV import: ↑ Import CSV button → upload → auto-map columns → import
Inbound leads from consulting.html and research.html appear automatically
Leaflet parish map. Supply corridors, agro-ecological zone classification, parish FSI overlay, farm boundary viewer. PostGIS-powered spatial queries from the Supabase production database.
Layer toggle — switch between FSI overlay, production zones, supply corridors
Click any parish — FSI score, ABRS average, enrolled farmer count
Farm boundaries — enrolled farmers with GPS data show farm polygons
The CRM automatically receives leads from both the consulting form and the research whitepaper download gate. Open /crm in one browser tab and submit the consulting form in another — the new contact appears in the CRM within 3 seconds via BroadcastChannel.
Reference
Platform Glossary.
ABRS
Agricultural Business Readiness Score. 0–100 creditworthiness and market-readiness score across five pillars: Business Formalisation, Production Capacity, Quality & Certification, Market Access, Financial Management. Grade A = 70+.
AMIB
Agricultural Marketing Information Bureau. RADA's weekly price reporting system. 186,000+ records covering 14 parishes and 12 commodity categories, 2019–2026. The primary data source for all HelloAG price intelligence.
CVI
Commodity Volatility Index. A 0–100 price instability index computed weekly across 12 commodity categories. CVI above 25 = Elevated. Current CVI: 31. Thyme and Scotch Bonnet are the primary drivers.
FSI
Food Security Index. Jamaica's national food security composite score (0–100) computed weekly from four components: price stability, supply availability, food access, and climate risk. National score: 74.2.
HAG-ID
HelloAG Identification Number. Unique identifier assigned to every enrolled farmer on the platform. Format: HAG-JM-001XXX. Links the farmer's enterprise records, ABRS score, GPS boundary, and marketplace transactions.
HAG Credits
Platform-native credit unit (future). Will be used for marketplace transactions and platform access fees. Not yet activated — post-Denbigh implementation.
JAIS
Jamaica Agricultural Intelligence System. The production intelligence layer — harvest calendar, agro-ecological zone data, production cluster mapping. Feeds the FSI supply availability component.
TAII
Tourism Agricultural Intelligence Infrastructure. The HelloAG module that connects hotel procurement desks to verified Jamaican farmers. Forward contracting, supplier matching, GS1 traceability.
TEA-RED
Tourism Enhancement and Agriculture Rural Economic Development. Project TEA-RED is the institutional framework (through CADE Group Inc.) for replicating the HelloAG OS model across CARICOM member states.
DataBridge
HelloAG's shared data bus — BroadcastChannel + localStorage + Supabase. Allows all platform modules to share data in real time. Farmer registration in Sentinel updates the FSI in Intelligence automatically.
BroadcastChannel
Native browser API used by HelloAG for cross-tab communication on the same domain. Consulting form and research modal use it to send new leads to the CRM without a server.
Reference
Complete File List.
All 56 files deploy to the public_html root on Hostinger. No subdirectories. See HelloAG_Hostinger_Guide.html for the complete upload sequence.
Always deploy helloag-databridge.js with the real Supabase anon key (not the placeholder that ends in ".placeholder"). All live data queries will silently fail without it.
56 files · 28 clean URL routes · See HelloAG_Hostinger_Guide.html for the full deployment procedure.