{"id":13722333,"url":"https://github.com/gridstatus/gridstatus","last_synced_at":"2025-12-14T18:00:40.484Z","repository":{"id":50496528,"uuid":"518969805","full_name":"gridstatus/gridstatus","owner":"gridstatus","description":"Extract data from ISOs and other energy grid sources","archived":false,"fork":false,"pushed_at":"2025-12-08T01:43:20.000Z","size":13616,"stargazers_count":372,"open_issues_count":54,"forks_count":70,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-12-08T01:51:11.087Z","etag":null,"topics":["co2-emissions","decarbonization","electrical-grid","energy","python"],"latest_commit_sha":null,"homepage":"https://opensource.gridstatus.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gridstatus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2022-07-28T19:24:20.000Z","updated_at":"2025-12-06T22:49:52.000Z","dependencies_parsed_at":"2024-01-16T05:15:46.861Z","dependency_job_id":"e97b0875-b208-4565-9d71-e6d4baa50fb0","html_url":"https://github.com/gridstatus/gridstatus","commit_stats":{"total_commits":453,"total_committers":29,"mean_commits":"15.620689655172415","dds":0.4061810154525386,"last_synced_commit":"f213022ae44032e7d98d6123c53256b29e0cac5d"},"previous_names":["kmax12/isodata","gridstatus/gridstatus","kmax12/gridstatus"],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/gridstatus/gridstatus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridstatus%2Fgridstatus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridstatus%2Fgridstatus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridstatus%2Fgridstatus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridstatus%2Fgridstatus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gridstatus","download_url":"https://codeload.github.com/gridstatus/gridstatus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridstatus%2Fgridstatus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27695810,"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-12-12T02:00:06.775Z","response_time":129,"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":["co2-emissions","decarbonization","electrical-grid","energy","python"],"created_at":"2024-08-03T01:01:27.513Z","updated_at":"2025-12-14T18:00:40.471Z","avatar_url":"https://github.com/gridstatus.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n\u003cimg width=75% src=\"./gridstatus-header.png\" alt=\"gridstatus logo\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003c!-- disable until tests more reliable --\u003e\n    \u003c!-- \u003ca href=\"https://github.com/gridstatus/gridstatus/actions?query=branch%3Amain+workflow%3ATests\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://github.com/gridstatus/gridstatus/workflows/Tests/badge.svg?branch=main\" alt=\"Tests\" /\u003e\n    \u003c/a\u003e --\u003e\n    \u003ca href=\"https://codecov.io/gh/gridstatus/gridstatus\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://codecov.io/gh/gridstatus/gridstatus/branch/main/graph/badge.svg\" alt=\"Code Coverage\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://badge.fury.io/py/gridstatus\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://badge.fury.io/py/gridstatus.svg?maxAge=2592000\" alt=\"PyPI version\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n`gridstatus` is a Python library that provides a uniform API for accessing electricity supply, demand, and pricing data for the major Independent System Operators (ISOs) in the United States and Canada. It currently supports data from CAISO, SPP, ISONE, MISO, ERCOT, NYISO, PJM, IESO, and the EIA.\n\n## GridStatus.io and Hosted API\nTo preview some of the data this library provides access to, visit [GridStatus.io](https://www.gridstatus.io/).\n\nIf you are trying to use our hosted API, you might want to check out the gridstatusio library [here](https://github.com/gridstatus/gridstatusio).\n\nTo learn more about our hosted API visit: https://www.gridstatus.io/api.\n\n## Community\n\n- Need Help? Post a [GitHub issue](https://github.com/gridstatus/gridstatus/issues)\n- Want to stay updated? Follow us on Twitter [@grid_status](https://twitter.com/grid_status)\n- Want to contribute? Read our [Contributing Guide](CONTRIBUTING.md)\n\n## Installation\n\n`gridstatus` supports python 3.11+. Install with uv\n\n```\nuv pip install gridstatus\n```\n\nUpgrade using the following command\n\n```\nuv pip install --upgrade gridstatus\n```\n\n## Environment Variables\n\n- Some parsers require the use of environment variables\n  - The `EIA` class\n  - The `ErcotAPI` class\n- Environment variables can be set in the following ways\n  - In a `.env` file in the root of the project\n  - In the environment where the code is run\n- See [.env.template](.env.template) for the required environment variables and how to register for them\n\n\n## Documentation and Examples\n\nTo learn more, visit the [documentation](https://opensource.gridstatus.io/) and view [example notebooks](https://opensource.gridstatus.io/en/latest/Examples/caiso/index.html).\n\n## Get Help\n\nWe'd love to answer any usage or data access questions! Please let us know by posting a GitHub issue.\n","funding_links":[],"categories":["Energy Systems"],"sub_categories":["Energy Data Accessibility and Integration"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgridstatus%2Fgridstatus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgridstatus%2Fgridstatus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgridstatus%2Fgridstatus/lists"}