goldmeya088-web/agrilink-web

To empower every smallholder farmer in Uganda with a single intelligent platform that connects farming, markets, transport, finance, and AI, improving productivity, profitability, and food security. # Ayute Farmers An AI-agent system for Ugandan smallholder farmers — built for the **AYuTe Africa Challenge Uganda (Season 5, deadline 24 July 2026)**. A **WhatsApp-style chat app** with an AI agronomist that speaks **Luganda + English**, reads photos, and helps manage farms, fields, pests, chemicals, and farm employees. It also offers a marketplace, reports, and "Farm Memory" (year-over-year insight). ## Status The MVP is **feature-complete and runs locally**, now built on the four-pillar architecture from `ayute-workflow.txt` — **Identity, Activity, Intelligence, Marketplace**. Register as any of 7 roles (farmer, agronomist, buyer, transporter, input_supplier, extension_officer, admin); post Farm Status updates with photos that the AI automatically analyses and routes to your assigned agronomist; browse a GPS-ranked marketplace; and see a feed-centric home. **50/50 backend tests pass.** Works in **demo mode** with no setup; add a Gemini key to become a real bilingual vision agent (AgriLink Intelligence Layer) automatically. See `diggers/ayuteproject` for the living spec, phases, and progress. ## Run it (on your phone / Termux) The virtual environment is already created. Just start the server: cd /root/ayute-farmers ./venv/bin/uvicorn backend.app:app --port 8000 Then open **http://localhost:8000** in your phone browser. To use a different AI model or provider, copy `.env.example` to `.env` and edit `GEMINI_MODEL` / `AI_PROVIDER`. First-time setup (only if `venv/` is missing): python3 -m venv venv ./venv/bin/pip install -r requirements.txt ## Turn on the live AI (optional) Create `passwards/gemini_key.txt` and paste a Google **Gemini** API key inside it. The chat and disease-photo features will then use the real model (`gemini-flash-latest`) for Luganda + English answers and vision. Without it, the app stays in safe demo mode. **`passwards/` is gitignored — never commit secrets.** ## Project structure - `diggers/ayuteproject` — project spec + progress (si …