Climate Forsight

Prototype of a system that answers questions about climate change impacts on planned human activities.

Running with docker

simplest: running prebuild container

You should have Docker installed. Then execute:

docker pull koldunovn/climsight:stable
docker run -p 8501:8501 -e OPENAI_API_KEY=$OPENAI_API_KEY climsight

Then open http://localhost:8501/ in your browser.

Build and run container with the latest code

You should have the following packages installed:

• git
• wget
• docker

As long as you have them, do:

git clone https://github.com/koldunovn/climsight.git
cd climsight
./download_data.sh
docker build -t climsight .
docker run -p 8501:8501 climsight

Then open http://localhost:8501/ in your browser. If you don't want to add OpenAI key every time, you can expose it through:

docker run -p 8501:8501 -e OPENAI_API_KEY=$OPENAI_API_KEY climsight

where $OPENAI_API_KEY not necesarelly should be environment variable, you can insert the key directly.

Installation

The easiest way is to install it through conda or mamba. We recomend mamba, as it's faster.

Install mamba if you don't have it.

git clone https://github.com/koldunovn/climsight.git
cd climsight

Create environment and install necessary packages:

mamba env create -f environment.yml

Activate the environment:

conda activate climsight

Before you run

You have to download example climate data and NaturalEarth coastlines. Change to the To do it simply run:

./download_data.sh

You would also need an OpenAI API key to run the prototype. You can provide it as environment varaible:

export OPENAI_API_KEY="???????"

There is a possibility to also provide it in the running app. The cost of each request (status September 2023) is about 6 cents with gpt-4 and about 0.3 cents with gpt-3.5-turbo (you can change it in the beggining of climsight.py script).

Running

Change to the climsight folder:

cd climsight
streamlit run climsight.py

The browser window should pop up, with the app running. Ask the questions and dont' forget to press "Generate".