mirror of
https://github.com/SirBlobby/Hoya26.git
synced 2026-02-03 19:24:34 -05:00
2.6 KiB
2.6 KiB
Ethix
A sustainability platform that helps users detect and report greenwashing - misleading environmental claims made by companies and products. Powered by AI analysis using Google Gemini and Ollama.
About
Ethix enables users to:
- Scan Products: Use camera to detect brand logos and analyze environmental claims
- Report Greenwashing: Submit incidents with evidence (images or PDF reports)
- Browse Reports: Explore company sustainability reports and user-submitted incidents
- Chat with AI: Get answers about sustainability, recycling, and eco-friendly alternatives
Technology Overview
Frontend
- SvelteKit with Svelte 5
- TypeScript
- TailwindCSS 4
- Tauri (desktop builds)
- Three.js (3D effects)
Backend
- Flask (Python)
- Google Gemini AI
- Ollama (embeddings and vision)
- ChromaDB (vector database)
- MongoDB (document storage)
Quick Start
Prerequisites
- Node.js 18+ or Bun
- Python 3.10+
- MongoDB instance
- Google API Key
Backend Setup
cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python app.py
Frontend Setup
cd frontend
bun install # or npm install
bun run dev # or npm run dev
Using Docker Compose
docker-compose up
Services
| Service | Port | Description |
|---|---|---|
| Frontend | 5173 | SvelteKit development server |
| Backend | 5000 | Flask API server |
External Dependencies
The application requires access to:
| Service | Purpose |
|---|---|
| ChromaDB | Vector storage for RAG |
| Ollama | Embeddings and vision models |
| MongoDB | Incident and metadata storage |
| Google Gemini | AI analysis and chat |
Key Features
Greenwashing Detection
Submit product photos or company PDF reports for AI-powered analysis. The system:
- Detects brand logos using vision AI
- Extracts text from documents
- Searches for relevant context in the database
- Provides structured verdicts with confidence levels
RAG-Powered Chat
The AI assistant uses Retrieval-Augmented Generation to provide accurate, context-aware responses about sustainability topics.
Catalogue System
Browse and search:
- Company sustainability reports with semantic search
- User-submitted greenwashing incidents
- Filter by category and view detailed analysis
Environment Variables
Backend (.env)
GOOGLE_API_KEY=your_google_api_key
MONGO_URI=your_mongodb_connection_string
CHROMA_HOST=http://your-chromadb-host
OLLAMA_HOST=https://your-ollama-host