Sarateal

Farmer market access and food supply intelligence.

---

Sarateal connects supply, demand, prices, tenders, weather signals, and location intelligence into a simple API-first system for agricultural market coordination.

Features

• Farmer supply and buyer demand records
• Market, product, county, tender, and match workflows
• Price records and CSV price ingestion
• Supply-demand match generation
• Weather-risk signals from forecast data
• Market and county weather lookup
• Geocoding through Nominatim/OpenStreetMap
• Cached and verified location coordinates
• FastAPI backend with tested service layers

Installation

git clone https://github.com/<your-org-or-user>/sarateal.git
cd sarateal
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

Run the API

uvicorn app.main:app --reload

Open:

http://127.0.0.1:8000/docs

Run tests

pytest

Deployment command

For hosted environments, use:

uvicorn app.main:app --host 0.0.0.0 --port $PORT

For local Windows testing, use:

uvicorn app.main:app --host 0.0.0.0 --port 8000

Example endpoints

GET /health
GET /markets
GET /prices
POST /price-ingestion/csv
GET /weather/forecast
GET /market-weather/forecast
GET /county-weather/forecast
GET /geocoding/search
GET /stored-locations
PATCH /stored-locations/{stored_location_id}/verification

Data sources

Sarateal currently integrates with:

• Open-Meteo for weather forecast data.
• Nominatim/OpenStreetMap for geocoding, used through a cache-aware adapter with a custom User-Agent.