---
title: KCC AgriAdvisor
emoji: 🌾
colorFrom: green
colorTo: yellow
sdk: docker
pinned: false
app_port: 7860
---

# 🌾 KCC AgriAdvisor

AI-powered agricultural advisory for Indian farmers. The most comprehensive
open Indian agriculture AI stack — RAG over 16.5M Kisan Call Center records,
national pest forecast for 700 districts × 20 crops, block-level satellite
features, ICAR-cited dose recommendations.

## 📊 Performance

Independent benchmark — **100-query stratified sample** from
`IndiaAgriBench-498`, Indian farmer questions across pest, disease, nutrient,
irrigation, scheme, price, and crop-selection problem types.

| Metric | This Stack | Vanilla Gemini | Vanilla Groq |
|---|---|---|---|
| Citation rate | **0.91** | 0.00 | 0.00 |
| Banned-chemical leakage | **0.00** | 0.00 | 0.04 |
| Latency p50 (ms) | **787** | 9,978 | 1,015 |
| Judge — Citation (1-10) | **9.12** | 1.14 | 0.26 |
| Judge — Safety (1-10) | **8.48** | 8.67 | 5.50 |

Smoke re-run on the v4-merged stack (5-query sample, 2026-05-11) confirmed
citation rate 1.0, banned leak 0.0, latency p50 627 ms — at or above
baseline. Full benchmark: see the in-app **/proof** tab or
`eval/benchmark_full_2026-05-10.json` in the IP bundle (NDA-gated).

## Features

- **RAG chatbot** over 16.5M KCC Q&A — Hindi / English / 8 regional languages
- **Pest Early Warning** — district stacking model (AUC 0.937), 1-month lead time
- **Price Forecast** — presow_v4 P25/P50/P75, 290 crops
- **National Pest Heatmap** — 700 districts × 20 crops × 3 months, interactive
- **Citation Guard** — post-generation safety filter, negation-aware
- **Enterprise Dashboard** — B2B pest + price analytics

## Architecture (v4)

```
client → /query
  ↓
 topic guard → classify → v2 multi_step_retrieve (FAISS+BM25+rerank)
  ↓
 prompt build (system + safety + few-shot + retrieved context)
  ↓
 kcc_core.llm cascade: Groq → Gemini → local Llama (first success wins)
  ↓
 kcc_core.citation_guard.review (negation-aware banned-chem strikethrough,
                                  hard overrides, [1][2] citation check)
  ↓
 JSON { answer, sources, safety_warnings, backend, ... }
```

## HF Spaces Secrets required

| Secret | Purpose |
|---|---|
| `GROQ_API_KEY`    | Primary LLM (Groq llama-4-scout, fast) |
| `GEMINI_API_KEY`  | Fallback LLM + image diagnosis |
| `SECRET_KEY`      | JWT signing (≥32 hex chars) |
| `B2B_DEMO_PASSWORD` | Demo enterprise login |
| `HF_TOKEN`        | (Optional) Pull large data files from HF Dataset at boot |

## What's in this v4 merge (vs v2)

| Area | v2 (original) | v4 (this) |
|---|---|---|
| LLM cascade | inline in api.py | `kcc_core.llm` (one canonical path) |
| Backend tracking | always "groq" lie | actual model that answered |
| Banned chemicals | 26-item list, substring | 33-item, negation-aware |
| Citation guard | none post-gen | runs on every /query + /query/stream |
| Hard overrides | none | BPH ≠ Imidacloprid |
| Rate limiting | none | slowapi (120/min, 2000/hr default) |
| Request tracing | none | X-Request-ID middleware |
| `/pest-risk` state-only | open | requires B2B JWT |
| Frontend | Farmer + B2B tabs | + new **/proof** tab with benchmark charts + India pest heatmap |
| Tests | none | 19/19 passing |

Full IP bundle (LoRA v2, BGE-M3 index, 498-query eval, ICAR JSON) is
NOT in this Space — kept local for NDA-gated buyer sharing.