FarmLink AI 🌾

Connecting Farmers and Buyers with AI-Powered Agricultural Solutions

FarmLink AI is a comprehensive agricultural marketplace platform that bridges the gap between farmers and buyers, powered by artificial intelligence and modern web technologies.

🌐 Live Demo: https://farmlinkai.vercel.app/

🚀 Features

Core Marketplace

Direct Farm-to-Buyer Trading: Connect farmers directly with buyers, eliminating middlemen
Real-time Inventory Management: Track crop availability and stock levels
Smart Search & Filtering: Find crops by category, location, price range, and more
Secure Payment Integration: Razorpay payment gateway for safe transactions
Order Tracking: Real-time shipment tracking with multiple courier integrations

AI-Powered Features

Crop Recommendations: AI-driven crop suggestions based on soil, climate, and market demand
Price Forecasting: National-level commodity price predictions using Agmarknet data
Pest & Disease Detection: Image-based analysis for early pest/disease identification
Weather Integration: Real-time weather data for farming decisions

Community & Learning

Expert Forum: Q&A platform for agricultural experts and farmers
Learning Hub: Educational articles on modern farming techniques
Rating & Review System: Build trust through verified buyer-seller ratings
Achievement System: Gamification to encourage platform engagement

Security & Compliance

KYC Verification: Secure seller verification with encrypted document storage
Role-Based Access Control: Admin, Farmer, and Buyer roles with specific permissions
Fraud Prevention: Rate limiting, IP tracking, and suspicious activity detection
Data Encryption: End-to-end encryption for sensitive information

🛠️ Technology Stack

Backend

Framework: Flask (Python 3.11)
Database: PostgreSQL with SQLAlchemy ORM
Authentication: Flask-Login with secure session management
Email: Flask-Mail with SMTP support
Task Scheduling: APScheduler for background jobs

Frontend

UI Framework: Bootstrap 5
JavaScript: Vanilla JS with modern ES6+ features
Icons: Font Awesome
Image Processing: Cropper.js for profile pictures

AI & Data

AI Model: Google Gemini API for intelligent recommendations
Price Data: Agmarknet API (data.gov.in)
Weather API: OpenWeatherMap integration
Data Analysis: Pandas, NumPy, Statsmodels for forecasting

Payment & Communication

Payment Gateway: Razorpay
SMS Notifications: Twilio
Shipment Tracking: Shiprocket, India Post APIs

Deployment

Web Server: Vercel Serverless Functions
Platform: Vercel (recommended)
Database: PostgreSQL (managed, e.g., Supabase)
File Storage: Local filesystem (upgradeable to S3)

📋 Prerequisites

Python 3.11 or higher
PostgreSQL 12 or higher
pip (Python package manager)
Git

🔧 Installation

1. Clone the Repository

git clone https://github.com/Dipendra2003/Farmlink-AI.git
cd Farmlink-AI

2. Create Virtual Environment

python -m venv .venv

# Windows
.venv\Scripts\activate

# Linux/Mac
source .venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

4. Set Up Environment Variables

Copy .env.example to .env and fill in your values:

cp .env.example .env

Required Environment Variables:

# Application
BASE_URL=http://localhost:5000
SESSION_SECRET=your-secret-key-here

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/farmlink_db

# AI APIs
GEMINI_API_KEY=your-gemini-api-key
WEATHER_API_KEY=your-weather-api-key
AGMARKNET_API_KEY=your-agmarknet-api-key

# Email (Gmail)
MAIL_USERNAME=your-email@gmail.com
MAIL_PASSWORD=your-app-password
MAIL_DEFAULT_SENDER=your-email@gmail.com

# Payment
RAZORPAY_KEY_ID=your-razorpay-key-id
RAZORPAY_KEY_SECRET=your-razorpay-secret

# Encryption
KYC_ENCRYPTION_KEY=generate-using-fernet
ENCRYPTION_KEY=generate-using-fernet

Generate Encryption Keys:

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

5. Initialize Database

# The app will automatically create tables on first run
python main.py

6. Create Admin User

Access the application and register with role "admin" for the first user.

🚀 Running the Application

Development Mode

python main.py

Access at: http://localhost:5000

Production Mode (Gunicorn)

gunicorn main:app --workers 4 --bind 0.0.0.0:5000

🌐 Deployment to Vercel

1. Push to GitHub

git add .
git commit -m "Ready for deployment"
git push origin main

2. Create Vercel Account

Sign up at vercel.com
Connect your GitHub repository

3. Create PostgreSQL Database

Set up a managed PostgreSQL database (e.g., Supabase, Neon)
Copy the Database connection URL

4. Create Vercel Project

Import your repository to Vercel
The framework preset should automatically detect Python/Flask
Vercel uses vercel.json for configuration which is already provided

5. Set Environment Variables

Add all variables from .env.example in the Vercel Dashboard Settings:

BASE_URL: Your Vercel URL (e.g., https://farmlinkai.vercel.app)
DATABASE_URL: Your PostgreSQL connection string
SESSION_SECRET: Generate a random string
All API keys and credentials

6. Deploy

Click "Deploy" and wait for the build to complete.

📁 Project Structure

Farmlink-AI/
├── static/                 # Static files (CSS, JS, images)
│   ├── css/
│   ├── js/
│   ├── img/
│   └── uploads/           # User-uploaded files
├── templates/             # HTML templates
│   ├── admin/            # Admin dashboard
│   ├── ai/               # AI features
│   ├── auth/             # Authentication
│   ├── dashboard/        # User dashboards
│   ├── marketplace/      # Product listings
│   └── ...
├── app.py                # Flask application factory
├── main.py               # Application entry point
├── models.py             # Database models
├── routes.py             # Main routes
├── forms.py              # WTForms definitions
├── config.py             # Configuration
├── requirements.txt      # Python dependencies
├── vercel.json           # Vercel deployment config
└── .env.example          # Environment variables template

🔐 Security Features

Password Hashing: Werkzeug secure password hashing
CSRF Protection: Flask-WTF CSRF tokens
Session Security: HTTPOnly, Secure, SameSite cookies
Rate Limiting: Flask-Limiter for API endpoints
Input Sanitization: Bleach for HTML sanitization
SQL Injection Prevention: SQLAlchemy ORM
XSS Protection: Template auto-escaping
File Upload Validation: Type and size restrictions
KYC Encryption: Fernet symmetric encryption

👥 User Roles

Admin

Full system access
User management
Crop approval/rejection
Order management
Analytics dashboard
System settings

Farmer

List crops for sale
Manage inventory
Process orders
View earnings
Access AI tools
KYC verification

Buyer

Browse marketplace
Place orders
Track shipments
Rate products
View purchase history
Access learning resources

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

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

📧 Contact

Developer: Dipendra GitHub: @Dipendra2003 Repository: Farmlink-AI

🙏 Acknowledgments

Google Gemini API for AI capabilities
Agmarknet (data.gov.in) for agricultural data
Razorpay for payment processing
Vercel for hosting platform
Bootstrap team for UI framework
Flask community for excellent documentation

📊 API Documentation

Public Endpoints

GET /api/crops - List all available crops
GET /api/crop/<id> - Get crop details
GET /api/crop/<id>/stock - Check stock availability

Authenticated Endpoints

POST /api/cart/add/<crop_id> - Add to cart
POST /api/order/place - Place order
GET /api/orders/my - Get user orders
POST /api/rating/submit - Submit rating

Admin Endpoints

GET /api/admin/analytics - System analytics
POST /api/admin/crop/approve/<id> - Approve crop
GET /api/admin/users - List users

🐛 Known Issues

Large file uploads may timeout on free hosting tiers
SMS notifications require Twilio credits
Weather API has rate limits on free tier

🔮 Future Enhancements

Mobile app (React Native)
Multi-language support (Hindi, regional languages)
Blockchain for supply chain tracking
Advanced ML models for yield prediction
Integration with government schemes
Farmer insurance integration
Cold storage facility finder
Soil testing service integration

📈 Version History

v1.0.0 (Current)

Initial release
Core marketplace functionality
AI-powered features
Payment integration
Order tracking
Community features

Made with ❤️ for Indian Farmers

Name		Name	Last commit message	Last commit date
static		static
templates		templates
.env.example		.env.example
.gitignore		.gitignore
.vercelignore		.vercelignore
README.md		README.md
achievement_service.py		achievement_service.py
admin_analytics_routes.py		admin_analytics_routes.py
admin_crop_routes.py		admin_crop_routes.py
admin_order_routes.py		admin_order_routes.py
admin_security_routes.py		admin_security_routes.py
admin_shipment_routes.py		admin_shipment_routes.py
advanced_routes.py		advanced_routes.py
ai_services.py		ai_services.py
analytics_service.py		analytics_service.py
api_routes.py		api_routes.py
api_utils.py		api_utils.py
app.py		app.py
category_config.py		category_config.py
config.py		config.py
courier_adapters.py		courier_adapters.py
crop_ai_service.py		crop_ai_service.py
custom_session.py		custom_session.py
email_service.py		email_service.py
encryption_service.py		encryption_service.py
encryption_utils.py		encryption_utils.py
error_handlers.py		error_handlers.py
expert_forum_routes.py		expert_forum_routes.py
expert_forum_utils.py		expert_forum_utils.py
extensions.py		extensions.py
forms.py		forms.py
fraud_prevention_service.py		fraud_prevention_service.py
kyc_file_service.py		kyc_file_service.py
kyc_security.py		kyc_security.py
kyc_service.py		kyc_service.py
learning_recommendation_service.py		learning_recommendation_service.py
logging_config.py		logging_config.py
main.py		main.py
middleware.py		middleware.py
models.py		models.py
moderation_service.py		moderation_service.py
national_price_forecast_service.py		national_price_forecast_service.py
order_service.py		order_service.py
payment_routes.py		payment_routes.py
payment_service.py		payment_service.py
pest_detection_service.py		pest_detection_service.py
pyrefly.toml		pyrefly.toml
pyrightconfig.json		pyrightconfig.json
rating_notification_service.py		rating_notification_service.py
rating_routes.py		rating_routes.py
rating_service.py		rating_service.py
report_generator.py		report_generator.py
requirements.txt		requirements.txt
role_hierarchy.py		role_hierarchy.py
routes.py		routes.py
security_enhancements.py		security_enhancements.py
security_utils.py		security_utils.py
seo_utils.py		seo_utils.py
storage_utils.py		storage_utils.py
tracking_jobs.py		tracking_jobs.py
tracking_notifications.py		tracking_notifications.py
tracking_routes.py		tracking_routes.py
tracking_scheduler.py		tracking_scheduler.py
tracking_service.py		tracking_service.py
tracking_webhooks.py		tracking_webhooks.py
utils.py		utils.py
vercel.json		vercel.json

Latest commit

History

Folders and files

Repository files navigation