Installation

Python package

pip install freeact

Execution environment

freeact agents execute code actions in ipybox, a secure code execution environment.

Custom Docker image

To build a custom ipybox Docker image with freeact-skills pre-installed, create a dependencies.txt file:

dependencies.txt

freeact-skills = {version = "0.0.6", extras = ["all"]}
# Add additional dependencies here if needed

Note

dependencies.txt must follow the Poetry dependency specification format.

Then build the ipybox Docker image referencing the dependencies file:

python -m ipybox build -t gradion-ai/ipybox:custom -d dependencies.txt

To use the image, reference it in CodeExecutionContainer when creating an ipybox Docker container. Use the env argument to set any API keys required by the pre-installed skills.

Tutorial Docker image

For running the tutorials, we provide a custom ghcr.io/gradion-ai/ipybox:example image with the following dependencies pre-installed:

dependencies.txt

freeact-skills = {version = "0.0.6", extras = ["all"]}
matplotlib = "^3.10"
numpy = "^2.2"
pandas = "^2.2"
pygithub = "^2.5"
sympy = "^1.13"

Note

The tutorials run containers locally. Make sure you have Docker installed on your system.