SilkSphere 🐛

An Enterprise-Grade IoT & AI Platform for Modern Sericulture

Architecture · Features · Quick Start

---

🌟 Overview

SilkSphere bridges the gap between traditional silkworm farming and modern technology. It provides farmers with real-time environmental telemetry and instant AI-powered disease diagnostics, drastically reducing crop failure and maximizing silk yield.

The platform is built using a secure, decoupled microservices architecture, ensuring that proprietary AI models remain completely protected on the server side while delivering a lightning-fast experience on the frontend.

🏗️ Architecture

graph LR
    A[IoT Edge Devices] -->|TLS Secure| B(Firebase Cloud Firestore)
    B -->|Live onSnapshot| C[React/Vite Dashboard]
    C -->|Image Upload| D[FastAPI Backend]
    D -->|Inference| E[(MobileNetV2 CNN)]
    E -->|Prediction| D
    D -->|JSON Response| C

Loading

✨ Key Features

• Real-Time Telemetry: Live charts powered by Recharts visualize temperature, humidity, and CO2 in real-time.
• Deep Learning Diagnostics: A custom-trained MobileNetV2 CNN instantly detects silkworm diseases (e.g., Grasserie) from uploaded images.
• Microservices Design: The heavy AI compute is offloaded to a dedicated Python backend, preventing frontend battery drain and browser crashes.
• Enterprise Security: Hardened with CORS restrictions, API rate limiting, .env secret management, and strict payload validation.

📂 Project Structure

• /SilkSphere: The user-facing React (Vite) Single Page Application.
• /backend: The secure FastAPI Python server hosting the AI model.
• /iot: Python hardware simulator generating live environmental data.
• /ml_training: Sandbox for CNN data augmentation and transfer learning.

🚀 Getting Started

To run the full stack locally, simply use the provided one-click startup scripts:

For Windows:

start.bat

For Mac/Linux:

./start.sh

These scripts will automatically launch the Backend API, the IoT Simulator, and the React Frontend in parallel.

🛡️ Security Note

This repository adheres to strict security standards. All sensitive credentials, including the Firebase Admin serviceAccountKey.json, are explicitly excluded from version control.