AI-powered ESG compliance automation platform with enterprise-grade security
ESG Copilot helps small and medium businesses automate sustainability reporting by using AI agents to research regulations, collect ESG data, calculate emissions, and generate compliance reports (GRI, SASB, TCFD).
- Regulation Research Agent - Identifies applicable ESG frameworks and deadlines
- ESG Data Collection Agent - Gathers environmental, social, and governance metrics
- Emissions Calculator Agent - Calculates Scope 1, 2, 3 carbon footprint via Climatiq API
- Report Generator Agent - Creates GRI/SASB/TCFD reports with iterative refinement
- Chat Agent - Permission-aware RAG for company-specific ESG queries
- ✅ Universal Login - Secure authentication with JWT tokens
- ✅ Token Vault - API keys (Climatiq, SendGrid, Pinecone) injected into JWT for authorized users only
- ✅ FGA Store - Fine-grained document-level authorization with company data isolation
- ✅ Role-Based Access - 4 roles (Company Admin, ESG Consultant, Auditor, Regulator)
- ✅ Audit Logging - Complete action history in BigQuery
- Company Admins see only their own company data
- ESG Consultants access all companies
- Auditors and Regulators have read-only access
- Zero knowledge leakage between companies
Frontend: Next.js 14, Auth0 Next.js SDK, TailwindCSS
Backend: Node.js, Express, LangChain.js, Google Gemini 2.5 Flash
Data: BigQuery (audit logs, ESG data), Pinecone (RAG vector DB), Auth0 FGA Store
APIs: Climatiq (emissions), SendGrid (email), Pinecone (vector search)
- Node.js 18+
- Google Cloud account (BigQuery)
- Auth0 account
- Pinecone account
- Climatiq API key
- SendGrid API key
- Clone repository
git clone https://github.com/omkardongre/ESG-Copilot.git
cd ESG-Copilot- Install dependencies
npm install
cd frontend && npm install && cd ..- Configure environment variables
cp .env.example .env
# Edit .env with your credentials- Setup BigQuery
- Create dataset in Google Cloud
- Run schema from
docs/EXTERNAL_SERVICES_SETUP.md
- Setup Auth0
- Create Auth0 application
- Configure roles, permissions, and Token Vault action
- Setup FGA Store authorization model
- See
docs/EXTERNAL_SERVICES_SETUP.mdfor details
- Start services
# Terminal 1: Backend
npm start
# Terminal 2: Frontend
cd frontend && npm run dev- Access application
- Frontend: http://localhost:3000
- Backend: http://localhost:3001
| Password | Role | Access | |
|---|---|---|---|
tesla@company.com |
Test@1234 |
Company Admin | Own company only |
patagonia@company.com |
Test@1234 |
Company Admin | Own company only |
consultant@esgfirm.com |
Test@1234 |
ESG Consultant | All companies |
auditor@sustainapilot.com |
Test@1234 |
Auditor | Read-only |
regulator@epa.gov |
Test@1234 |
Regulator | Read-only |
This is a demonstration project. For production use, please review security configurations and scale infrastructure accordingly.
MIT License - See LICENSE file for details
- GitHub: https://github.com/omkardongre/ESG-Copilot
- Auth0 for AI Agents: https://auth0.com/ai-agents