FarmWise is your personal agronomic advisor and farm management system, accessible right from your phone via WhatsApp. Our mission is to increase agricultural productivity, sustainability, and profitability for farmers across Africa by making expert agronomic advice accessible to everyone.
FarmWise combines local agricultural knowledge with modern technology to provide personalized advice and support for farming operations. The platform aims to:
- Make expert agricultural advice accessible to all farmers through WhatsApp
- Increase agricultural productivity through personalized recommendations
- Improve farm sustainability with climate-smart guidance
- Enhance profitability through market insights and optimized practices
- Bridge the digital divide by working on basic phones without app downloads
- 🌱 Crop Recommendations - Personalized crop selection based on soil, climate, and market conditions
- 🌦️ Weather Forecasts - Localized weather data for effective farm planning
- 🐛 Pest & Disease Management - Expert identification and treatment advice with image diagnosis
- 📅 Planting Calendar - Customized planting schedules for specific crops and regions
- 📊 Farm Analytics - Performance tracking with detailed insights and reports
- 👥 Community Support - Connection with other farmers and agricultural experts
- 📱 WhatsApp Integration - Full platform access via WhatsApp messaging
- 💰 Market Prices - Real-time commodity pricing and market trends
In this use case example, a farmer spots a crop pest, sends a photo to the FarmWise bot via WhatsApp, and instantly gets a diagnosis and solution. Workflows in the FarmWise backend alert neighboring farmers who may be affected by the same pest, helping the entire community protect their crops.
No app downloads or complicated interfaces required! Simply:
- Save our number: +254 708 883040
- Send "Hello" to start
- Follow the prompts to set up your farm profile
apps/farmbase/- Core FastAPI backend with multi-tenant architectureapps/farmwise/- AI agent service with WhatsApp integrationapps/farmbase-workflows/- Temporal workflow engine for background tasksfrontend/- React web console for farm management
libs/farmbase-client/- Auto-generated API clientlibs/isdasoil-api-client/- Africa soil data integration
- GAEZ (Global Agro-ecological Zones) climate and suitability data
- KALRO (Kenya Agricultural Research Organization) crop varieties
- KAMIS (Kenya Agricultural Market Information System) prices
- ISDA Africa soil property maps
- Weather data integration via Temporal workflows
- Python ≤ 3.13
- Node.js (for frontend)
- PostgreSQL with PostGIS extension
- OpenAI API key
- Clone and setup environment:
git clone <repository-url>
cd farmwise
echo 'OPENAI_API_KEY=your_openai_api_key' >> .env- Start database:
docker-compose up db- Install dependencies:
uv sync- Run database migrations:
cd apps/farmbase
uv run alembic upgrade head- Start services:
# Backend API
cd apps/farmbase && uv run fastapi dev src/farmbase/main.py
# AI Agent Service
cd apps/farmwise && uv run python src/farmwise/main.py
# Frontend (in separate terminal)
cd frontend && npm install && npm run devTODO: Describe WhatsApp business API configuration
# Format code
uv run poe fmt
# Lint with auto-fix
uv run poe lint
# Type checking
uv run poe check
# Run tests
uv run poe test
# Run all checks
uv run poe all# Create migration after model changes
cd apps/farmbase
uv run alembic revision --autogenerate -m "Description"
# Apply migrations
uv run alembic upgrade head# Generate updated API client
uv run poe client-gen- PostgreSQL with PostGIS for spatial data
- Schema-based multi-tenancy (
farmbase_organization_{slug}) - Automatic organization routing via middleware
- Async SQLAlchemy with SQLModel
- Backend: FastAPI, SQLAlchemy, PostgreSQL, Temporal
- Frontend: React, TypeScript, Vite
- AI: OpenAI APIs, custom agricultural agents
- Geospatial: PostGIS, GeoPandas, rioxarray
- Communication: WhatsApp Business API
- Infrastructure: Docker, uv for dependency management
- Follow the existing code conventions
- Use the provided linting and formatting tools
- Add tests for new functionality
- Update documentation as needed
Sustainable use license. Please contact [email protected] for alternative licensing.
© 2025 FarmWise. All rights reserved.