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.
- Download the
.exeinstaller from the GREET website. - Double-click the installer.
- Follow the prompts in the installer.
- Open PyGREET from the Start Menu, the Desktop or the Taskbar search box.
- Download the
.dmgfile from the GREET website. - Open the
.dmgfile. - Drag the application to your Applications folder.
- Open PyGREET from Launchpad or Spotlight Search.
PyGREET for Linux is a .deb package built for x64 (amd64) systems on Ubuntu.
- Download the
.debfile from the GREET website. - Install the package with one of these methods:
- In the terminal:
- With a graphical installer: double-click the
.debfile to open it in your system's software installer.
- Open PyGREET from the Application menu, or type
pygreetin 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.

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:
- Uninstall PyGREET and install it again.
- Make sure PyGREET has permission to run on your machine.
- 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:
- The Feedback form on the PyGREET dashboard
- An email to pygreet-feedback@anl.gov