Skip to content

haileyhendrickson/EIA

Repository files navigation

EIA API

A GUI-based Python tool to query two reports from the EIA API. The program efficiently queries a Natural Gas Prices and Futures report, and an Electric Power Operations report from https://www.eia.gov/opendata/browser/natural-gas/pri and https://www.eia.gov/opendata/browser/electricity/facility-fuel, respectively.

Features

  • 📊 Natural Gas Prices & Futures - Query comprehensive pricing data
  • Electric Power Operations - Access facility and fuel data
  • 📅 Flexible Date Ranges - Select custom time periods
  • 📁 Excel Export - Processed data ready for analysis
  • 🖥️ User-Friendly GUI - No command line required

Installation

  1. Clone this repository:
    git clone https://github.com/haileyhendrickson/EIA.git
    cd EIA
    

Use

Download the .exe file and enjoy!

Tutorial Video (click to watch):

Watch the video

For End Users

The application comes pre-configured with an API key - no setup required! Just download and run.

For Developers

To build from source, you'll need to set the EIA_API_KEY environment variable before building.

Running on a Local Machine:

  • python -m venv venv # create a new env
  • source venv/Scripts/activate # activate env
  • pip install -r requirements.txt # install dependencies

Notes for use

  • Temporary partial files will appear during data retrieval but are deleted when processing completes.

Version History -- Last updated: July 2025 (version 2)

  • v1.0: Initial release - Included Natural Gas Report
  • v2.0: Added Energy Power Operations Report

License

This project is licensed under the MIT License.

About

Repo for the EIA API tool, for pulling Natural Gas prices and Unit Generation.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published