Measure the Environmental Impact of Generative AI
EcoLogits Calculator is an open-source interactive tool for estimating the energy consumption and environmental footprint of generative AI models. Developed by the non-profit CodeCarbon, this calculator helps individuals, researchers, and organizations understand and evaluate the sustainability of AI usage.
The calculator provides:
- Energy consumption estimates for AI model inference
- Environmental impact assessments including carbon emissions and water usage
- Real-world scaling analysis to understand the broader impact
- Support for multiple AI providers and models
- Educational insights into sustainable AI practices
- 🧮 Interactive Calculator: Easily estimate environmental impacts by selecting a provider, model, and example usage
- 🤓 Expert Mode: Advanced options for users who want granular control over calculations
- 🏢 Company Mode: Estimate the aggregate environmental footprint of AI usage across an organisation
- 👽 Expert Company Mode: Multi-model, multi-scenario analysis of token volumes and aggregated environmental impacts.
- 🪙 Token Estimator: Understand tokenization and estimate token counts for your inputs
- 📊 Visualization: Interactive charts showing environmental equivalences and scaling projections
- 🌐 Multi-Provider Support: Evaluate impacts across different AI providers and models
- 📖 Methodology Documentation: Transparent, science-backed calculation methods
- 📱 Web-Based Interface: No installation needed—access directly through the web
The Calculator is available at calculator.ecologits.ai.
If you want to run the calculator locally, follow the instructions below.
- Python 3.13+
- uv package manager
# Clone the repository
git clone https://github.com/mlco2/ecologits-calculator.git
cd ecologits-calculator
# Install dependencies using uv
uv sync
# Run the application
uv run streamlit run app.pyThe calculator will open in your browser at http://localhost:8501
The basic workflow of the EcoLogits Calculator involves the following steps:
- Select Model: Choose an AI provider and model from the available options
- Provide Input: Enter example prompts or text that you want to evaluate
- View Results: Instantly see energy consumption and environmental impact estimates
- Explore Equivalences: Understand impacts in relatable terms (e.g., "equivalent to driving X km")
- Analyze Scaling: See how impacts multiply when scaled to larger populations
- Energy Consumption: Measured in kWh per inference
- Carbon Emissions: Estimated CO₂ equivalent based on energy grid composition
- Other Environmental Impacts: Water usage, resource consumption, etc.
- Scaling Analysis: Projections for 1% of world population using the same prompt daily for one year
- Methodology: Detailed explanation of how environmental impacts are calculated
- EcoLogits Documentation: Learn about the underlying EcoLogits library
- CodeCarbon: Learn more about the organization behind this project
We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to:
- Report bugs
- Suggest features
- Submit pull requests
- Set up your development environment
This project is licensed under the CC BY-SA 4.0 License.
If you find this tool helpful, please consider:
- ⭐ Starring this repository
- 💬 Sharing feedback and suggestions
- 🤝 Contributing to the project
- 💝 Supporting CodeCarbon on their mission to make AI more sustainable
Have questions or feedback? Feel free to:
- Open an issue
- Start a discussion
- Contact CodeCarbon
Developed with ❤️ by CodeCarbon