Skip to content

ohanyere/animal-check

Repository files navigation

FarmVet AI 🐔

AI-Powered Livestock Disease Detection & Care Assistant

FarmVet AI helps farmers diagnose livestock health issues instantly using AI.
Users can upload an image of their animal, describe symptoms, and receive an AI-generated diagnosis, prevention guidelines, care instructions, and alerts on whether to seek a veterinarian immediately.

🔗 Live Demo: (https://animal-check.vercel.app/)
🧠 Powered by Google Gemini


🚀 Key Features

  • 📸 Image-Based Diagnosis
    Upload livestock photos (chickens, goats, pigs, etc.) for instant AI analysis.

  • ✍️ Symptom Description Input
    Users can type additional notes for more accurate diagnosis.

  • 🤖 AI-Generated Disease Identification
    Gemini analyzes the image + description to suggest likely diseases.

  • 🩺 Care & Treatment Recommendations
    Includes prevention steps, first aid care, and proper handling.

  • ⚠️ Vet Urgency Indicator
    AI tells users if the case is mild, moderate, or requires immediate vet attention.

  • 🌍 Multi-language Support
    Powered by i18next with multiple locale folders.

  • 🔐 User Authentication
    Secure login/signup using Firebase or your chosen auth service.

  • 📱 Fully Responsive UI
    Modern, mobile-first design for farmers using phones on the field.


🛠️ Tech Stack

Frontend

  • React
  • TypeScript
  • Vite
  • Tailwind CSS
  • Framer Motion

AI Layer

  • Google Gemini API

Backend

  • Custom API utilities (image processing, prompt engineering)

State Management

  • Redux Toolkit
  • Redux Persist

Internationalization

  • i18next

Auth

  • Firebase Authentication (Email/Password)

🧠 How the AI Diagnosis Works

  1. User uploads an image of their livestock

  2. User adds optional text describing symptoms

  3. App sends image + description to Gemini API

  4. AI returns:

    • Possible disease
    • Confidence level (if implemented)
    • Prevention steps
    • Care/treatment instructions
    • Vet urgency indicator
  5. Output is displayed on the results page.


📂 Folder Structure

public/
src/
 ├── assets/
 ├── Components/
 │    ├── benefits/
 │    ├── Button/
 │    ├── Faq/
 │    ├── footer/
 │    ├── marquee/
 │    └── Navigation/
 ├── features/
 │    └── auth/
 ├── hooks/
 ├── locales/
 │    ├── de/
 │    ├── en/
 │    ├── fr/
 │    ├── ig/
 │    ├── nl/
 │    └── yb/
 ├── Pages/
 │    ├── about/
 │    ├── contact/
 │    ├── Dashboard/
 │    ├── ForgetPassword/
 │    ├── home/
 │    ├── notFound/
 │    ├── profile/
 │    ├── Result/
 │    ├── Signin/
 │    └── SignUp/
 ├── store/
 └── utils/

📦 Installation

Clone the repo:

git clone https://github.com/your-username/farmvet-ai.git
cd livestock

Install dependencies:

npm install

Add your Gemini API key to a .env file:

VITE_GEMINI_API_KEY=your_api_key_here

Run development server:

npm run dev

🔐 Authentication Setup (Firebase Example)

  1. Create a Firebase project
  2. Enable Email/Password Auth
  3. Add your Firebase keys to .env:
VITE_FIREBASE_API_KEY=
VITE_FIREBASE_AUTH_DOMAIN=
VITE_FIREBASE_PROJECT_ID=

🧪 Testing (if implemented)

npm run test

or Cypress:

npx cypress open

🚀 Deployment

Build:

npm run build

Preview:

npm run preview

Deploy to:

  • Vercel

📸 Screenshots

🏡 Home Page

Home Page

📤 Upload Workflow

Upload Page




## 📜 License

MIT License © 2025 Francis

---

## 🤝 Contributing

PRs are welcome.  
For major updates, open an issue first to discuss.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors