📑 Table of Contents

• 🌱 CarbonX - AI-Powered Carbon Credit Trading Platform
• 🚀 Live Demo
• ✨ Features
  • 🤖 AI-Powered Tools
  • 💹 Carbon Trading & Finance
  • 🌐 Web3 & Blockchain
  • 🎨 User Experience
• 🛠️ Technology Stack
  • Frontend
  • AI & Backend
  • Blockchain & Web3
  • DevOps & Deployment
• 🚀 Quick Start
  • Option 1: Docker
  • Option 2: Manual Setup
• 📱 Application Structure
• 🤖 AI Features
  • Carbon Calculator
  • Plastic Footprint Analyzer
  • Event Planner
  • Chatbot Assistant
• 🔗 API Documentation
• 🌍 Environmental Impact
• 🤝 Contributing
• 📄 License
• 👨‍💻 Developer
• 🙏 Acknowledgments
• 📊 Project Stats
• ✨ Contributors

🌱 CarbonX - AI-Powered Carbon Credit Trading Platform

Next-generation sustainability platform combining AI tools, carbon credit trading, and blockchain technology for environmental impact management.

🚀 Live Demo

🔗 Visit CarbonX Platform (Running locally)

✨ Features

🤖 AI-Powered Tools

• AI Carbon Calculator - Instant carbon footprint analysis with emission calculations and credit recommendations
• AI Plastic Footprint - Smart plastic waste analysis with reduction strategies and sustainable alternatives
• Sustainable Event Planner - AI-powered eco-friendly event planning with carbon tracking
• FAQ Chatbot - Intelligent assistant powered by Google Gemini AI for instant platform support

💹 Carbon Trading & Finance

• Secure Trading Platform - Buy and sell verified carbon credits from certified projects
• Portfolio Management - Track carbon credit investments and environmental impact
• Real-time Analytics - Live market data and sustainability metrics
• Cryptocurrency Integration - Support for carbon-related crypto investments and green tokens

🌐 Web3 & Blockchain

• Smart Contracts - Ethereum-based carbon credit tokenization and trading
• MetaMask Integration - Secure wallet connectivity and transaction management
• ThirdWeb Integration - Simplified Web3 development and deployment

🎨 User Experience

• Modern Dark Theme - Professional, accessible design with smooth animations
• Responsive Design - Optimized for desktop, tablet, and mobile devices
• Interactive Navigation - Mega menu with organized feature categories
• Developer Hub - Real-time GitHub integration with contribution charts

🛠️ Technology Stack

Frontend

• Framework: Next.js 14.2.5 with App Router
• Language: TypeScript 5.0
• Styling: Tailwind CSS 3.4 + Framer Motion
• UI Components: Lucide React Icons + Custom Components

AI & Backend

• AI Integration: Google Generative AI (Gemini 1.5-flash)
• Backend: Next.js API Routes + FastAPI (Python)
• Database: PostgreSQL (planned)
• Authentication: NextAuth.js

Blockchain & Web3

• Blockchain: Ethereum + EVM-compatible networks
• Smart Contracts: Solidity + Hardhat
• Web3 Library: ThirdWeb + Ethers.js
• Wallet: MetaMask integration

DevOps & Deployment

• Containerization: Docker + Docker Compose
• Development: Hot reload for all services
• Production: Multi-stage builds with optimization
• Orchestration: Service networking and health checks

🚀 Quick Start

Option 1: Docker (Recommended)

Prerequisites: Docker and Docker Compose

# Clone repository
git clone https://github.com/AkshitTiwarii/carbonx.git
cd carbonx

# Set up environment
cp .env.example .env.local
# Add your API keys to .env.local

# Start entire stack
docker-compose -f docker-compose.dev.yml up -d

# Access application
open http://localhost:3000

Option 2: Manual Setup

Prerequisites: Node.js 18+, Python 3.8+

1. Install dependencies

npm install
cd backend && pip install -r requirements.txt
cd ../smart_contracts && npm install

2. Set up environment

cp .env.example .env.local
# Add your API keys

3. Start services

# Terminal 1: Blockchain
cd smart_contracts && npx hardhat node

# Terminal 2: Backend
cd backend && uvicorn main:app --reload

# Terminal 3: Frontend
npm run dev

📱 Application Structure

carbonx/
├── src/
│   ├── app/                    # Next.js App Router pages
│   │   ├── ai-calculator/      # AI Carbon Calculator
│   │   ├── plastic-calculator/ # AI Plastic Footprint
│   │   ├── event-planner/      # Sustainable Event Planner
│   │   ├── faqs/              # FAQ with AI Chatbot
│   │   ├── developer/         # Developer Hub
│   │   ├── trading/           # Carbon Credit Trading
│   │   ├── portfolio/         # Investment Portfolio
│   │   └── api/               # API Routes
│   ├── components/            # Reusable UI Components
│   ├── hooks/                 # Custom React Hooks
│   ├── lib/                   # Utility Libraries
│   └── types/                 # TypeScript Definitions
├── smart_contracts/           # Ethereum Smart Contracts
├── backend/                   # Python FastAPI Backend
└── public/                    # Static Assets

🤖 AI Features

Carbon Calculator

• Real-time emission calculations using AI models
• Personalized carbon credit recommendations
• Integration with verified offset projects

Plastic Footprint Analyzer

• Comprehensive plastic waste impact analysis
• AI-powered reduction strategy suggestions
• Sustainable product alternative recommendations

Event Planner

• Sustainable event planning with AI assistance
• Carbon footprint estimation for events
• Eco-friendly vendor and location suggestions

Chatbot Assistant

• 24/7 platform support powered by Google Gemini
• Comprehensive knowledge base about CarbonX features
• Natural language understanding for user queries

🔗 API Documentation

AI Calculator API

POST /api/ai-calculator
Content-Type: application/json

{
  "transport": "car",
  "energy": "electricity",
  "waste": "recycling",
  "consumption": "moderate"
}

Trading API

GET /api/trading/prices
Response: Array of carbon credit prices and market data

Portfolio API

GET /api/crypto/prices?category=all
Response: Real-time cryptocurrency and carbon token prices

🌍 Environmental Impact

CarbonX is committed to sustainability:

• Carbon Neutral Platform: All operations offset through verified projects
• Transparency: Open-source codebase and public impact metrics
• Education: Free tools and resources for carbon footprint awareness
• Innovation: Advancing Web3 solutions for environmental challenges

🤝 Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

Quick Start for Contributors

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

For detailed contribution guidelines, code standards, and best practices, please read our Contributing Guide.

Development Guidelines

• Follow TypeScript best practices
• Use Tailwind CSS for styling
• Write tests for new features
• Update documentation as needed
• Create an issue before working on major features

📄 License

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

You are free to use, modify, and distribute this project in accordance with the license terms.

👨‍💻 Developer

Akshit Tiwari

• 🐙 GitHub: @AkshitTiwarii
• 💼 LinkedIn: akshit-tiwarii
• 📧 Email: akshittiwari29@gmail.com

🙏 Acknowledgments

• Google AI for Gemini AI integration
• ThirdWeb for Web3 development tools
• Vercel for Next.js framework
• Tailwind CSS for styling system
• Open source carbon data providers and environmental organizations

📊 Project Stats

• Languages: TypeScript, Python, Solidity
• Framework: Next.js 14 with App Router
• AI Integration: Google Gemini 1.5-flash
• Blockchain: Ethereum smart contracts
• UI/UX: Modern dark theme with responsive design

---

✨ Contributors

Thanks to all the wonderful contributors 💖

See full list of contributor contribution Contribution Graph

---

🌱 Building a sustainable future with AI and blockchain technology

⭐ Star this repository if you find it helpful!