Before We Start

How to install and run the Interaction Composition Explorer
The recipes in this primer are implemented using the Interactive Composition Explorer (ICE). If you’d like to follow along with the implementation (strongly recommended), set it up first.


ICE requires Python 3.10. If you only have newer or older version(s) of Python installed, we recommend using pyenv to install Python 3.10 and manage multiple Python versions.
If you use Windows, you'll need to run ICE inside of WSL.


As part of general good Python practice, consider first creating and activating a virtual environment to avoid installing ICE 'globally'. For example:
python3.10 -m venv venv
source venv/bin/activate
Install ICE:
pip install ought-ice
Obtain an OPENAI_API_KEY and create an .env file containing it in the ICE folder:
OPENAI_API_KEY=sk-...f8 # Replace with your API key.
Start the ICE server in its own terminal and leave it running:
python -m ice.server