{"id":47819322,"url":"https://github.com/zwony/ecotrace","last_synced_at":"2026-04-26T10:01:53.838Z","repository":{"id":344824354,"uuid":"1183282396","full_name":"Zwony/ecotrace","owner":"Zwony","description":" A lightweight Python library to measure the carbon footprint of your code","archived":false,"fork":false,"pushed_at":"2026-04-19T08:36:48.000Z","size":6452,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-19T10:26:37.811Z","etag":null,"topics":["carbon-footprint","climate","co2","energy-efficiency","green-software","profiling","python","sustainability"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zwony.png","metadata":{"files":{"readme":"README.MD","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.MD","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.MD","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.MD","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-16T13:04:02.000Z","updated_at":"2026-04-19T08:34:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Zwony/ecotrace","commit_stats":null,"previous_names":["zwony/ecotrace"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/Zwony/ecotrace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zwony%2Fecotrace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zwony%2Fecotrace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zwony%2Fecotrace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zwony%2Fecotrace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zwony","download_url":"https://codeload.github.com/Zwony/ecotrace/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zwony%2Fecotrace/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32292958,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carbon-footprint","climate","co2","energy-efficiency","green-software","profiling","python","sustainability"],"created_at":"2026-04-03T19:02:35.835Z","updated_at":"2026-04-26T10:01:53.833Z","avatar_url":"https://github.com/Zwony.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"logo.png\" width=\"200\" alt=\"EcoTrace Logo\"\u003e\n\n# EcoTrace\n\n### High-Precision Energy and Emissions Instrumentation\n---\n**v0.8.0 is now live!** Includes new CLI profiling, JSON export API, and enhanced hardware detection.\n---\n\n**EcoTrace is a lightweight library for granular carbon footprint measurement of Python applications. No configuration files, no background services—just real-time hardware-level transparency.**\n\nReal-time monitoring · 50+ Global Zones · AI-powered insights · Zero-configuration\n\n\u003cbr\u003e\n\n[![PyPI - Version](https://img.shields.io/pypi/v/ecotrace.svg?color=2E8B57\u0026style=for-the-badge\u0026logo=pypi\u0026logoColor=white)](https://pypi.org/project/ecotrace/)\n[![Python 3.9+](https://img.shields.io/badge/python-3.9+-3776AB.svg?style=for-the-badge\u0026logo=python\u0026logoColor=white)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-22c55e.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n[![Downloads](https://img.shields.io/pepy/dt/ecotrace?style=for-the-badge\u0026color=blue\u0026logo=pypi\u0026logoColor=white)](https://pepy.tech/project/ecotrace)\n[![VS Code Extension](https://img.shields.io/badge/VS_Code-EcoTrace-007ACC?style=for-the-badge\u0026logo=visual-studio-code)](https://marketplace.visualstudio.com/items?itemName=ecotrace-team.ecotrace-monitor)\n\n\u003cbr\u003e\n\n\u003e [!TIP]\n\u003e **VS Code Extension:** Monitor application carbon footprint in real-time during development. [Download here](https://marketplace.visualstudio.com/items?itemName=ecotrace-team.ecotrace-monitor).\n\n\u003cbr\u003e\n\n![EcoTrace Demo](demo.gif)\n\n*Function-level carbon measurement with real-time monitoring*\n\n\u003c/div\u003e\n\n---\n\n## Quick Install\n\n```bash\npip install ecotrace\n```\n\n---\n\n## Quick Start\n\n### Option 1: Zero-Code Profiling (CLI)\nMeasure any script without changing a single line of code:\n\n```bash\necotrace run my_script.py\n```\n\n### Option 2: Programmatic Tracking (Library)\nDecorate functions for granular instrumentation:\n\n```python\nfrom ecotrace import EcoTrace\n\n# region_code: Use ISO 3166-1 alpha-2 (e.g., US, TR, DE). See docs/SUPPORT.md for full list.\neco = EcoTrace(region_code=\"US\")\n\n@eco.track\ndef my_function():\n    # Your heavy processing here\n    pass\n\nmy_function()\n\n# Export audit-ready reports or check cumulative totals\neco.generate_pdf_report(\"carbon_audit.pdf\")\nprint(f\"Total Carbon Emitted: {eco.total_carbon} gCO2\")\n```\n\n### Expected Output\nWhen initialized, EcoTrace performs automated hardware detection:\n\n```text\n---------------------------------\n--- EcoTrace v0.8.0 Initialized ---\nRegion  : US (367 gCO2/kWh)\nCPU     : 13th Gen Intel Core i9-13900K\nTDP     : 125.0W\nMonitoring: Active (50ms sampling)\n---------------------------------\n```\n\n---\n\n## Why EcoTrace?\n\n| Feature | **EcoTrace** | CodeCarbon | CarbonTracker |\n|---|:---:|:---:|:---:|\n| **Sampling Interval** | **50ms** | 15s | Per Epoch |\n| **Isolation** | **Process-scoped** | System-wide | System-wide |\n| **Dependencies** | **Zero (Core)** | 10+ (Pandas, etc.) | 5+ |\n| **Async Support** | **Native** | Limited | No |\n\n- **Deep Transparency:** Derived from verified manufacturer TDP specifications rather than category averages.\n- **Fail-Safe Architecture:** Guaranteed application continuity even if hardware drivers or API keys are missing.\n- **Actionable AI:** Integrates with Google Gemini to provide specific code optimization advice (optional).\n\n---\n\n## Documentation\n\n- [**Architecture and Science**](docs/ARCHITECTURE.md) — How the energy model and process isolation work.\n- [**Advanced Usage**](docs/USAGE.md) — GPU tracking, AI insights, benchmarks, and comparison tables.\n- [**Support and Reference**](docs/SUPPORT.md) — Troubleshooting, region codes, and hardware compatibility.\n\n---\n\n## Contributing\n\nWe welcome contributions! Please see our [**CONTRIBUTING.MD**](CONTRIBUTING.MD) for guidelines on reporting bugs, suggesting features, or contributing hardware data.\n\n---\n\n## Community\n\n[![Join Discord](https://img.shields.io/discord/1483105790993633411?label=Join%20Community\u0026logo=discord\u0026style=for-the-badge\u0026color=5865F2)](https://discord.gg/hs58XXb3Uq)\n\n[CHANGELOG.md](CHANGELOG.md) · [SECURITY.MD](SECURITY.MD)\n\n---\n\n## Author and License\n\n**Emre Ozkal** — [GitHub](https://github.com/Zwony) · [ecotraceteam@gmail.com](mailto:ecotraceteam@gmail.com)\n\nMIT License — Use it however you like.\n\n\u003cdiv align=\"center\"\u003e\n\n*Developed for sustainable software development practices.*\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzwony%2Fecotrace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzwony%2Fecotrace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzwony%2Fecotrace/lists"}