{"id":33148702,"url":"https://github.com/GreenScheduler/cats","last_synced_at":"2025-11-20T10:01:24.393Z","repository":{"id":161492111,"uuid":"636172215","full_name":"GreenScheduler/cats","owner":"GreenScheduler","description":"CATS: the Climate-Aware Task Scheduler 🐈 🐈‍⬛","archived":false,"fork":false,"pushed_at":"2025-09-17T09:10:11.000Z","size":9375,"stargazers_count":71,"open_issues_count":29,"forks_count":12,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-11-12T03:05:27.152Z","etag":null,"topics":["carbon","carbon-footprint","climate","computing","electricity","electricity-consumption","energy","energy-consumption","job-scheduler","scheduling"],"latest_commit_sha":null,"homepage":"https://cats.readthedocs.io/","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/GreenScheduler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"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":"2023-05-04T09:16:56.000Z","updated_at":"2025-11-06T08:33:36.000Z","dependencies_parsed_at":"2023-07-05T01:46:07.736Z","dependency_job_id":"6a0fb3b1-6c7b-499c-83e5-9dcd6b54272d","html_url":"https://github.com/GreenScheduler/cats","commit_stats":{"total_commits":242,"total_committers":12,"mean_commits":"20.166666666666668","dds":0.8016528925619835,"last_synced_commit":"ef0e308898e0bceb0cd00a9cd075737e6c7a17fd"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/GreenScheduler/cats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenScheduler%2Fcats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenScheduler%2Fcats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenScheduler%2Fcats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenScheduler%2Fcats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GreenScheduler","download_url":"https://codeload.github.com/GreenScheduler/cats/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreenScheduler%2Fcats/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284333383,"owners_count":26986954,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-14T02:00:06.101Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","carbon-footprint","climate","computing","electricity","electricity-consumption","energy","energy-consumption","job-scheduler","scheduling"],"created_at":"2025-11-15T17:00:26.060Z","updated_at":"2025-11-20T10:01:24.381Z","avatar_url":"https://github.com/GreenScheduler.png","language":"Python","funding_links":[],"categories":["Emissions"],"sub_categories":["Carbon Intensity and Accounting"],"readme":"![CATS logo](docs/source/_static/cats_dalle_img_200x200px_for_logo.png)\n\n# CATS: **C**limate-**A**ware **T**ask **S**cheduler\n\nCATS is a **C**limate-**A**ware **T**ask **S**cheduler. It schedules cluster jobs to minimize predicted carbon intensity of running the process. It was created as part of the [2023 Collaborations Workshop](https://software.ac.uk/cw23).\n\nThe Climate-Aware Task Scheduler is a lightweight Python package designed to schedule tasks based on the estimated carbon intensity of the electricity grid at any given moment. This tool uses real-time carbon intensity data from the National Grid ESO via their API to estimate the carbon intensity of the electricity grid, and schedules tasks at times when the estimated carbon intensity is lowest. This helps to reduce the carbon emissions associated with running computationally intensive tasks, making it an ideal solution for environmentally conscious developers.\n\n*Demo showing CATS scheduling a 30 minute job using the `at` scheduler*\n![CATS animated usage example](cats.gif)\n\n\u003e [!NOTE]\n\u003e Currently CATS only works in the UK. If you are aware of APIs for realtime grid carbon intensity data in other countries please open an issue and let us know.\n\n[![DOI](https://joss.theoj.org/papers/10.21105/joss.08251/status.svg)](https://doi.org/10.21105/joss.08251)\n\n## Features\n\n- Estimates the carbon intensity of the electricity grid in real-time\n- Schedules tasks based on the estimated carbon intensity, minimizing carbon emissions\n- Provides a simple and intuitive API for developers\n- Lightweight and easy to integrate into existing workflows\n- Supports Python 3.9+\n\n## Installation\n\nInstall via `pip` as follows:\n\n```bash\npip install climate-aware-task-scheduler\n```\n\nTo install the development version:\n\n```bash\npip install git+https://github.com/GreenScheduler/cats\n```\n\n## Documentation\n\nDocumentation is available at https://cats.readthedocs.io\n\nWe recommend the\n[quickstart](https://greenscheduler.github.io/cats/quickstart.html#basic-usage)\nif you are new to CATS. CATS can optionally [display carbon footprint\nsavings](https://greenscheduler.github.io/cats/quickstart.html#displaying-carbon-footprint-estimates)\nusing a [configuration file](cats/config.yml).\n\n## Contributing\n\nWe welcome contributions from the community! If you find a bug or have an idea for a new feature, please open an issue on our GitHub repository or submit a pull request.\n\n## License\n\n[MIT License](https://github.com/GreenScheduler/cats/blob/main/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGreenScheduler%2Fcats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGreenScheduler%2Fcats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGreenScheduler%2Fcats/lists"}