Skip to content

EcoAudit AI helps small businesses create and implement sustainable practices through AI-powered analysis.

Notifications You must be signed in to change notification settings

readysethack/eco-audit-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EcoAudit AI

React 18 TypeScript 5 Flask 3 Gemini AI Docker License: MIT

This is a submission to the Qloo Hackathon

Overview

EcoAudit AI is a platform that helps small businesses create and implement sustainable practices through AI-powered region analysis.

Core Features

  • Sustainability Assessment: Business-specific analysis based on industry, location, and offerings
  • Practical Recommendations: Actionable sustainability improvements tailored for small businesses
  • Regional Context: Considers local regulations, resources, and cultural practices
  • User-Friendly Interface: Simple form-based input with clear, visual results

Architecture

┌────────────┐      ┌────────────┐      ┌────────────┐
│            │      │            │      │            │
│  React     │<────>│  Flask     │<────>│  AI        │
│  Frontend  │      │  Backend   │      │  Services  │
│            │      │            │      │            │
└────────────┘      └────────────┘      └────────────┘

Quick Start

Prerequisites

  • Docker and Docker Compose
  • Qloo and Gemini API keys

Docker Setup

# Clone repository
git clone https://github.com/yourusername/eco-audit-ai.git
cd qloo-hackathon-app

# Create .env file with API keys
# GEMINI_API_KEY=your_key
# QLOO_API_KEY=your_key
# VITE_API_URL=http://backend:5000

# Start services
docker-compose up -d

# Access application
# Frontend: http://localhost:3000
# Backend API: http://localhost:5000

API Endpoints

Create Audit

POST /audit/list

Business details → Sustainability audit with score, strengths, improvements and actionable tip

List Audits

GET /audit/list

Returns all generated audits, sortable by various parameters

See Backend README for complete API documentation.

Project Structure

eco-audit-ai/
├── backend/             # Flask REST API
│   ├── app.py           # API endpoints
│   └── utils/           # Business logic
├── frontend/            # React application
│   ├── src/
│   │   ├── components/  # UI components
│   │   └── services/    # API client
└── docker-compose.yml   # Container orchestration

Development

See Backend README and Frontend README for detailed setup instructions.

License

MIT

About

EcoAudit AI helps small businesses create and implement sustainable practices through AI-powered analysis.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published