EcoBot

AI-powered environmental education chatbot with waste management features. Built with FastAPI backend, React frontend (admin and user apps), and PostgreSQL database.

Features

• AI chatbot for environmental education
• Waste classification and recycling guidance
• TPS (Waste Collection Point) locator with map integration
• Admin panel for content management
• Multi-language support (ID/EN)
• Telegram bot integration

Tech Stack

• Backend: FastAPI, Python 3.12, SQLAlchemy, PostgreSQL
• Frontend: React, Vite, TypeScript, TailwindCSS
• Infrastructure: Docker, GitHub Actions CI/CD

Quick Start (Development)

# Backend
cd backend
cp .env.example .env
uv sync
uv run uvicorn app.main:app --reload

# Frontend Admin
cd frontend/admin
npm install
npm run dev

# Frontend User
cd frontend/user
npm install
npm run dev

Quick Start (Docker)

cp backend/.env.example backend/.env
docker compose up -d

Endpoints:

• Backend API: http://localhost:8000
• Admin Panel: http://localhost:5173
• User App: http://localhost:3001

Documentation

• Deployment Guide