Skip to content

austinbediako/Ai-Environmental-Impact-Analyzer

Repository files navigation

🌍 AI Environmental Impact Analyzer

🌟 Project Overview

The AI Environmental Impact Analyzer is a decentralized Web3 application designed to calculate and present the environmental impact of consumer goods. By leveraging blockchain technology and artificial intelligence, the tool ensures transparency, trust, and community engagement in promoting sustainable consumer behavior. It analyzes product descriptions, manufacturing details, and supply chain information to generate an environmental footprint score.

This project empowers users to make eco-friendly choices while ensuring that contributions remain part of a shared, open ecosystem under the protection of a decentralized license.


✨ Features

  • 🔍 Product Description Analysis: Uses AI to parse and understand product descriptions.
  • 🏭 Manufacturing Data Insights: Evaluates the environmental impact of manufacturing processes.
  • 🚚 Supply Chain Assessment: Tracks supply chain details to determine carbon footprint and sustainability.
  • 📊 Environmental Footprint Score: Aggregates data into a comprehensible score for the user.
  • 💻 User-Friendly Interface: Interactive dashboard for displaying detailed analysis and suggestions for eco-friendly alternatives.
  • 🔗 Blockchain Integration: Ensures data integrity and decentralized storage of impact analyses.
  • 🛡️ Secure Web3 Authentication: Allows users to log in with crypto wallets (e.g., MetaMask) to maintain privacy and decentralization.

🛠️ Tech Stack

🎨 Frontend

  • React.js: For building a responsive and dynamic user interface.
  • Tailwind CSS: For modern and customizable styling.
  • Web3.js / Ethers.js: For blockchain interactions.

🌐 Backend

  • Node.js with Express.js: For handling API requests and server-side logic.
  • Python (FastAPI): For AI model integration and data analysis.
  • IPFS (InterPlanetary File System): For decentralized file storage.

🤖 AI/ML

  • Natural Language Processing (NLP): To analyze textual data like product descriptions and supply chain details.
  • TensorFlow/PyTorch: For training and deploying AI models.
  • Pre-trained Models: Fine-tuned models like BERT for textual analysis.

🗄️ Blockchain

  • Ethereum / Polygon: For decentralized smart contract execution.
  • Smart Contracts: Written in Solidity to handle tokenized incentives and contributions.

⚙️ Installation

Prerequisites

  • Node.js and npm
  • Python (version 3.8 or higher)
  • MetaMask or another Web3 wallet
  • IPFS CLI (optional for local decentralized storage)

Setup Instructions

  1. Clone the repository:

    git clone https://github.com/yourusername/ai-environmental-impact-analyzer.git
  2. Navigate to the project directory:

    cd ai-environmental-impact-analyzer
  3. Install dependencies for the frontend:

    cd client
    npm install
  4. Install dependencies for the backend:

    cd ../server
    npm install
  5. Set up the Python environment for AI:

    python -m venv env
    source env/bin/activate # For Windows: env\Scripts\activate
    pip install -r requirements.txt
  6. Configure environment variables:

    • Create a .env file in both client and server directories.
    • Add your MongoDB URI, API keys, and other secrets.
  7. Run the application:

    • Start the backend:
      cd server
      npm start
    • Start the frontend:
      cd client
      npm start

📖 Usage

  1. Open the application in your browser.
  2. Log in or create an account.
  3. Input product details or upload relevant documentation.
  4. View the environmental footprint score and detailed analysis.
  5. Explore recommendations for more sustainable alternatives.

🧠 AI Model Details

  • Training Data: Includes datasets on supply chain emissions, manufacturing processes, and sustainability metrics.
  • Algorithm: Fine-tuned transformer models for textual analysis combined with regression models for scoring.
  • Output: Scores are normalized between 0 (eco-friendly) and 100 (high environmental impact).

🚀 Roadmap

  1. Phase 1: Core functionality (MVP)
    • Decentralized Product analysis and footprint scoring.
  2. Phase 2: Blockchain integration
    • Smart contract for tokenized rewards.
    • Decentralized data storage with IPFS.
    • Eco-friendly product suggestions.
    • Integration with e-commerce platforms.
  3. Phase 3: Scalability
    • Global decentralized database.
    • Multilingual and multi-chain support.

🤝 Contributing

We welcome contributions from the community! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Commit your changes and push the branch to your fork.
  4. Create a pull request with a detailed description of your changes.

📜 License

This project is licensed under the GNU General Public License v3.0.


📧 Contact

For questions or feedback, please reach out to:

Feel free to report issues or suggest improvements via the GitHub Issues page.

Key Updates:

  1. Decentralization Focus: Included Web3, blockchain, and IPFS integration.
  2. Web3 Authentication: Secure login via crypto wallets.
  3. License: Highlighted a decentralized-friendly license for contribution protection.
  4. Blockchain Roadmap: Added details on tokenized rewards and smart contracts.

If you’d like help by Contributing, let me know!

Releases

No releases published

Packages

 
 
 

Contributors