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.9, 3.10, or 3.11. If you don't have a supported version of Python installed, we recommend using pyenv to install a supported Python version 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
The first time you run a recipe that uses recipe.agent(), you will be prompted for an OpenAI API key that will automatically be stored in ~/.ought-ice/.env.