KisanAI an open source, farmer facing Next.js app providing curated government schemes, market prices, voice assistant, and tools to help farmers make informed decisions.

Badges: [build] [license] [contributors]

Overview

• Purpose: central portal for Indian farmers with translations, AI assisted insights, and offline friendly features.
• Tech: Next.js (App Router), React, TypeScript, Tailwind CSS, Jest

Quick links

• Documentation: docs/
• Contributing: CONTRIBUTING.md
• Issue templates: .github/ISSUE_TEMPLATE/
• CI: .github/workflows/

Getting started (developer) See docs/LOCAL_SETUP.md for local setup instructions and environment variables.

Contributing We welcome contributions. Read CONTRIBUTING.md and the code of conduct before opening issues or PRs.

Community

• Check ROADMAP.md for planned work and milestones.
• For support and security reporting see SUPPORT.md and SECURITY.md.

Maintainers

• See CODEOWNERS and repository maintainers in the docs.

KisanAI AI powered assistant for farmers to access crop insights, schemes, market data, and voice tools.

• About
• Features
• Screenshots
• Architecture
• Folder Structure
• Quick Start
• Local Development Badges: [build] [license] [contributors] [GSSoC]
• Tech Stack
• Contributing
• Open Source Programs
• Maintainers
• Roadmap
• License

KisanAI is a progressive web app built with Next.js + TypeScript that provides farmers with contextual agricultural information, government scheme guidance, calendar/task management, and voice-based interactions.

• AI-assisted crop analysis

• Voice assistant (speech recognition + synthesis)

• Offline-first data with IndexedDB

• Market price and weather integrations

• Government scheme tracking

• Responsive, accessible UI

• Maintainer: Ashish Parab (asheesh109) — ashishparab03@gmail.com

• Next.js for SSR/SSG and API routes
• React components structured under src/components
• Business logic and utilities under src/lib
• Hooks under src/hooks
• Data seeds under src/data

Key folders:

• src/app/ — Next.js routes and pages
• src/components/ — UI components
• src/hooks/ — Reusable hooks
• src/lib/ — Utilities, API, DB adapters
• src/data/ — Seed data and fixtures
• src/types/ — Shared TypeScript types

1. Clone

git clone https://github.com/asheesh109/KisanAI.git
cd KisanAI
npm install

2. Run locally

npm run dev

3. Run tests / lint

npm run test
npm run lint
npm run type-check

Create .env.local with at least:

• NEXT_PUBLIC_API_URL — API base URL
• MONGODB_URI — optional DB connection
• OPENAI_API_KEY — optional for AI features

• Next.js, React, TypeScript
• TailwindCSS
• Jest + React Testing Library
• GitHub Actions for CI

We welcome contributions. Please read CONTRIBUTING.md first.

This repo is organized and labeled to support GSSoC and Hacktoberfest contributors.

A concise flow for new contributors:

Discover issue -> Claim -> Create branch -> Implement -> Open PR -> Review -> Merge

• Beginner-friendly: look for good first issue or beginner labels.
• For program-specific guidance see docs/GSSOC_GUIDE.md and docs/HACKTOBERFEST_GUIDE.md.

• Maintainer: Ashish Parab (asheesh109) — ashishparab03@gmail.com
• For questions, use GitHub Discussions or email ashishparab03@gmail.com for sensitive matters.

• See CODEOWNERS for primary maintainers.

See ROADMAP.md

MIT — see LICENSE

KisanAI is a cutting edge AI powered farmer assistant platform designed specifically for Indian farmers. Built with modern web technologies and powered by advanced AI models, KisanAI provides intelligent, actionable insights to help farmers make better decisions.

Whether it's crop disease analysis, weather forecasting, market prices, or government scheme navigation, KisanAI delivers comprehensive assistance through an intuitive, voice-enabled interface in Hindi and English.

To democratize AI-powered agricultural intelligence, making it accessible to every farmer in India through simple, voice-enabled technology.

A future where every farmer has access to real-time insights, AI-powered decision support, and government benefit information, breaking down barriers of literacy and technology adoption.

• Hindi & English Support: Natural language voice interaction
• Speech Recognition: Accurate voice input processing
• Text-to-Speech: Clear audio responses
• Offline Capable: Works without internet connection
• Multi-turn Conversations: Context-aware dialogues

• Image Upload: Analyze crop diseases from photos
• AI Detection: Using Gemini Vision API
• Disease Identification: Instant diagnosis with confidence scores
• Treatment Recommendations: Actionable solutions
• Disease Prevention: Tips for future prevention

• Location-Based: Precise weather data for farmer's location
• 7-Day Forecast: Extended weather predictions
• Alerts: Severe weather notifications
• Rainfall Data: Monsoon and precipitation tracking
• Historical Data: Seasonal patterns and analysis

• Real-Time Updates: Live market data
• Price Trends: Historical price analysis
• Market Insights: Supply-demand indicators
• Price Alerts: Notification system for price changes
• Multi-Commodity: Coverage of major agricultural commodities

• Scheme Discovery: Browse all major government schemes
• Eligibility Checker: Interactive tool to find applicable schemes
• Application Support: Step-by-step KCC and other applications
• Benefits Lookup: Understand scheme benefits clearly
• Application Status: Track submitted applications

• Digital Forms: Streamlined application process
• Document Management: Upload and manage documents
• Status Tracking: Real-time application status
• Mobile Optimized: Complete on mobile devices
• Hindi Support: Forms available in Hindi

• Hindi Language: Complete Hindi localization
• English Support: Full English interface
• Easy Addition: Extensible i18n system for more languages
• Regional Context: Location-specific content

• Offline First: Works without internet
• Install to Home: App-like experience
• Push Notifications: Stay updated
• Fast Loading: Optimized performance
• Mobile Responsive: Perfect on all devices

Screenshots coming soon - Help us add them!

Live URL: kisanai (Demo environment - May contain sample data)

Try features:

• 🎤 Voice Assistant Demo
• 📸 Crop Analysis Demo
• 🌦️ Weather Demo
• 📈 Market Prices Demo
• 📋 Schemes Portal Demo

• Framework: Next.js 16 (React 19)
• Language: TypeScript 5
• Styling: Tailwind CSS 4.1
• UI Components: Radix UI, Lucide Icons
• Animations: Framer Motion
• Forms: Custom React forms with validation

• Runtime: Node.js
• Database: MongoDB with Mongoose
• API Client: Axios
• AI Integration: Google Generative AI (Gemini)
• Voice: ElevenLabs TTS

• Testing: Jest + React Testing Library
• Linting: ESLint
• Type Checking: TypeScript
• Build Tool: Next.js Build System
• Package Manager: npm

• Target: Vercel / Self-hosted
• PWA: next-pwa for offline support

KisanAI/
├── src/
│   ├── app/                      # Next.js App Router
│   │   ├── api/                  # API routes
│   │   ├── layout.jsx            # Root layout
│   │   ├── page.jsx              # Home page
│   │   ├── crop-analysis/        # Crop disease analysis
│   │   ├── kcc-application/      # KCC application form
│   │   ├── market-prices/        # Market prices
│   │   ├── schemes/              # Government schemes
│   │   ├── voice-assistant/      # Voice chat interface
│   │   ├── weather/              # Weather forecasting
│   │   └── calendar/             # Farming calendar
│   │
│   ├── components/               # React components
│   │   ├── layout/               # Layout components
│   │   ├── ui/                   # Reusable UI components
│   │   └── [feature]/            # Feature-specific components
│   │
│   ├── hooks/                    # Custom React hooks
│   │   ├── useSpeechRecognition.js
│   │   ├── useSpeechSynthesis.js
│   │   └── [custom hooks]/
│   │
│   ├── lib/                      # Utility libraries
│   │   ├── api.ts               # API client
│   │   ├── mongodb.ts           # Database connection
│   │   ├── geminiTranslate.ts   # AI integration
│   │   └── [utilities]/
│   │
│   ├── data/                     # Static data
│   ├── types/                    # TypeScript types
│   ├── contexts/                 # React contexts
│   └── __tests__/                # Test files
│
├── public/                       # Static assets
├── docs/                         # Documentation
├── .github/                      # GitHub config
│   ├── workflows/                # CI/CD workflows
│   ├── ISSUE_TEMPLATE/           # Issue templates
│   └── pull_request_template.md
│
├── package.json
├── tsconfig.json
├── tailwind.config.js
├── next.config.js
├── jest.config.js
├── eslint.config.mjs
├── README.md                     # You are here
├── CONTRIBUTING.md               # Contribution guide
├── CODE_OF_CONDUCT.md           # Community guidelines
├── ROADMAP.md                    # Development roadmap
├── SECURITY.md                   # Security policy
└── LICENSE                       # MIT License

┌─────────────────────────────────────────────────────┐
│                     User Interface                   │
│  (Next.js/React Components + Tailwind CSS)          │
└────────────────┬────────────────────────────────────┘
                 │
┌────────────────▼────────────────────────────────────┐
│                  API Routes Layer                    │
│  (Voice Processing, Image Analysis, Data Fetch)    │
└────────────────┬────────────────────────────────────┘
                 │
┌────────────────▼────────────────────────────────────┐
│              Service Layer                          │
│  (AI Integration, Data Processing, Business Logic) │
└────────────────┬────────────────────────────────────┘
                 │
      ┌──────────┴──────────┬────────────────┬────────────┐
      │                     │                │            │
┌─────▼──────┐  ┌──────────▼────┐  ┌────────▼──────┐  ┌──▼──────────┐
│  MongoDB   │  │ Gemini API    │  │ ElevenLabs    │  │ Weather API │
│  Database  │  │ (AI/Vision)   │  │ (Voice)       │  │ (Data)      │
└────────────┘  └───────────────┘  └───────────────┘  └─────────────┘

• Node.js: 18.0 or higher (Download)
• npm: 9.0 or higher (comes with Node.js)
• Git: Latest version (Download)
• MongoDB: Local instance or cloud connection string

# 1. Clone the repository
git clone https://github.com/yourusername/KisanAI.git
cd KisanAI

# 2. Install dependencies
npm install

# 3. Configure environment variables
cp .env.example .env.local
# Edit .env.local with your API keys

# 4. Start development server
npm run dev

# 5. Open in browser
open http://localhost:3000

Create .env.local file:

# MongoDB
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/kisanai

# Google Gemini API
NEXT_PUBLIC_GEMINI_API_KEY=your_gemini_api_key
GEMINI_MODEL=gemini-pro-vision

# ElevenLabs Voice API
ELEVENLABS_API_KEY=your_elevenlabs_key

# Weather API
WEATHER_API_KEY=your_weather_api_key

# App Configuration
NEXT_PUBLIC_APP_URL=http://localhost:3000
NODE_ENV=development

# Start development server with turbopack
npm run dev

# Build for production
npm run build

# Start production server
npm start

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Generate coverage report
npm run test:coverage

# Lint code
npm run lint

# Format code
npm run format

We use Jest and React Testing Library for comprehensive testing.

# Run all tests
npm test

# Watch mode (re-run on changes)
npm run test:watch

# Generate coverage report
npm run test:coverage

# CI mode (for GitHub Actions)
npm run test:ci

src/__tests__/
├── components/     # Component tests
├── hooks/         # Hook tests
├── pages/         # Page tests
└── lib/           # Utility tests

Testing Guide | Example Tests

Complete documentation is available in the docs/ directory:

1. Read CONTRIBUTING.md - Understand our process
2. Check Good First Issues - Find starter tasks
3. Follow Setup Guide - Get development environment running
4. Read CODING_STANDARDS.md - Learn code style
5. Create your PR! - Submit changes

• Check Intermediate Issues
• Review ARCHITECTURE.md for system design
• Explore feature implementation patterns
• Help code review pull requests

• Check Advanced Issues
• Lead feature implementation
• Review and mentor other contributors
• Help maintain architecture quality

KisanAI is an official GSSoC 2025 project!

• 📝 110+ Issues specifically curated for different skill levels
• 🏆 Regular Milestones with achievable goals
• 👥 Active Mentorship from core team
• 🎯 Clear Learning Path for beginners
• 🚀 Real-world Impact helping Indian farmers

Start Contributing to make a difference!

Perfect for Hacktoberfest participation:

• ✅ Beginner-friendly issues tagged good-first-issue
• ✅ Issues labeled hacktoberfest for easy filtering
• ✅ Quick-win tasks perfect for month-long challenge
• ✅ Supportive community for first-time contributors

Find Hacktoberfest Issues

• Voice Assistant with Hindi support
• Crop disease analysis
• Market prices tracking
• Government schemes portal
• KCC application system
• Weather forecasting

• User authentication & profiles
• Saved preferences & bookmarks
• Community discussions
• Expert consultation booking
• Mobile app (React Native)

• IoT sensor integration
• Predictive analytics
• Blockchain for certifications
• Farmer marketplace
• Insurance integration

See Full Roadmap

We ❤️ our contributors!

Want to join? Start here!

• 📖 Documentation
• 💬 GitHub Discussions
• 🐛 Report Issues
• 💌 Email Support

• 🐙 GitHub
• 🐦 Twitter/X
• 💼 LinkedIn

Please read our CODE_OF_CONDUCT.md - we are committed to providing a welcoming and inclusive environment.

This project is licensed under the MIT License - see the LICENSE file for details.

By contributing, you agree that your contributions will be licensed under its MIT License.

• Special thanks to all GSSoC mentors
• Community moderators and code reviewers
• Agricultural domain experts

• Next.js - React framework
• Tailwind CSS - Styling
• Radix UI - Components
• Google Gemini - AI Integration
• ElevenLabs - Voice API

• Getting Started Guide - Detailed setup instructions
• Architecture Documentation - System design
• API Reference - Available endpoints
• Coding Standards - Code style guide
• Testing Guide - Testing practices
• Security Policy - Reporting vulnerabilities

🌾 KisanAI - Empowering Farmers with AI 🚀

• Product Requirements Document (PRD)
• Implementation Plan

This project is designed to help Indian farmers access technology and government benefits. Contributions are welcome!

This project is developed as part of the Digital India initiative to empower farmers.

Demo URL: http://localhost:3001 (when running locally)
Status: Phase 1 Complete - Ready for AI/ML Integration
Last Updated: August 8, 2025

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.