Document dependency installation options (#26)

docs/installation.md

@@ -8,7 +8,11 @@ pip install freeact
 
 ## Execution environment
 
-`freeact` agents execute code actions in [`ipybox`](https://gradion-ai.github.io/ipybox/), a secure code execution environment.
+`freeact` uses [`ipybox`](https://gradion-ai.github.io/ipybox/) as its code execution environment, providing a secure Docker-based IPython runtime. You can either use [pre-built Docker images](https://github.com/gradion-ai/ipybox/pkgs/container/ipybox) or create a [custom Docker image](#custom-docker-image) with your specific requirements.
+
+!!! Note
+
+    Pre-built images run with root privileges. For non-root execution, build a [custom Docker image](#custom-docker-image) (and find further details in the `ipybox` [installation guide](https://gradion-ai.github.io/ipybox/installation/)).
 
 ### Custom Docker image
 
@@ -43,3 +47,25 @@ For running the [tutorials](tutorials/index.md), we provide a custom `ghcr.io/gr
 !!! Note
 
     The tutorials run containers locally. Make sure you have [Docker](https://docs.docker.com/get-docker/) installed on your system.
+
+### Installing dependencies at runtime
+
+In addition to letting an agent install required dependencies at runtime, you can install extra dependencies at runtime before launching an agent, which is useful for testing custom skills across agent sessions without rebuilding Docker images:
+
+```python
+from freeact import execution_environment
+
+async with execution_environment(ipybox_tag="ghcr.io/gradion-ai/ipybox:basic") as env:
+    # Install the serpapi package in the current environment
+    await env.executor.execute("!pip install serpapi")
+
+    # Import skill modules that depend on serpapi
+    skill_sources = await env.executor.get_module_sources(
+        module_names=["my_skill_module_1", "my_skill_module_2"],
+    )
+
+    # Initialize agent with the new skills
+    # ...
+```
+
+For production use, it's recommended to include frequently used dependencies in a custom Docker image instead.

docs/tutorials/skills.md

@@ -67,6 +67,9 @@ The example conversation was initiated with the following `freeact.cli` command.
 --8<-- "freeact/examples/commands.txt:cli-skills-weather"
 ```
 
+!!! Note
+    If you've developed a custom skill that has external dependencies, you either need to build a [custom Docker image](../installation.md#custom-docker-image) with the required dependencies or need to [install them at runtime](../installation.md#installing-dependencies-at-runtime) prior to launching an agent.
+
 ### Example conversation
 
 [![output-use](output/skills-use.svg)](output/skills-use.html){target="_blank"}