Skip to content

Install PyGREET

Install PyGREET on Windows, macOS or Linux and open it for the first time. PyGREET is a desktop application for life cycle analysis (LCA). It uses a bundled Python engine and local SQLite storage.

Check the System Requirements

PyGREET is tested on Windows 10 and Windows 11, macOS on Apple silicon, and Ubuntu amd64. Run it on one of these platforms.

Requirement Minimum
RAM 8 GB
CPU Dual-core processor
Storage 500 MB of available space
Screen resolution 1920x1080 is optimal. Lower resolutions work, but some elements can be hard to read.

Better hardware improves performance. These values are a base guideline.

Install the Application

Previous PyGREET installations

If you installed an earlier version of PyGREET, it can leave cache files behind. Remove these folders before you reinstall.

  • Windows (installed): C:\Users\<username>\AppData\Local\PyGREET
  • Linux (installed): ~/.local/share/pygreet/
  • Mac (installed): ~/Library/Application Support/PyGREET/

Select your operating system and follow the steps.

  1. Download the .exe installer from the GREET website.
  2. Double-click the installer.
  3. Follow the prompts in the installer.
  4. Open PyGREET from the Start Menu, the Desktop or the Taskbar search box.
  1. Download the .dmg file from the GREET website.
  2. Open the .dmg file.
  3. Drag the application to your Applications folder.
  4. Open PyGREET from Launchpad or Spotlight Search.

PyGREET for Linux is a .deb package built for x64 (amd64) systems on Ubuntu.

  1. Download the .deb file from the GREET website.
  2. Install the package with one of these methods:
    • In the terminal:
      sudo dpkg -i pygreet-*.deb
      sudo apt-get install -f
      
    • With a graphical installer: double-click the .deb file to open it in your system's software installer.
  3. Open PyGREET from the Application menu, or type pygreet in the terminal.

Note

The .deb package is built and tested on Ubuntu. Other Debian-based distributions (for example, Linux Mint and Pop!_OS) may also work but are not officially tested.

Open PyGREET for the First Time

On first launch, PyGREET initializes its local database and local files, so it takes longer than later launches. A splash screen with a loading bar shows while it loads.

When the launch succeeds, the dashboard opens. It shows your datasets and links to the feedback survey and the openLCA interoperability website.

Dashboard with the default dataset and the feedback and openLCA links
Figure 1: Dashboard with the default dataset and the feedback and openLCA links

Clone the default dataset

After the first launch, it is highly recommended that you clone the default dataset: select the triple-dot icon for the default dataset and clone it. Work in the clone. If you need the default data again, clone the default dataset a second time and activate the new clone.

Fix Installation Problems

If PyGREET does not install or start:

  1. Uninstall PyGREET and install it again.
  2. Make sure PyGREET has permission to run on your machine.
  3. If the error continues, send an email to pygreet-feedback@anl.gov.

Error log locations

When you report an issue, include the error log, error.log. The same folder holds app.log.

  • Windows: %APPDATA%\pygreet\logs\ (for example, C:\Users\<username>\AppData\Roaming\pygreet\logs\)
  • macOS: ~/Library/Logs/pygreet/
  • Linux: ~/.config/pygreet/logs/

Send Feedback

Your feedback helps refine PyGREET. Send it through either of these:

Next

Open a dataset and manage it on the Dashboard.