[Feature Request] Add package installation supports into code execution sandboxes

[lightaime]

Required prerequisites

• I have searched the Issue Tracker and Discussions that this hasn't already been reported. (+1 or comment there if it has.)
• Consider asking first in a Discussion.

Motivation

To give agents more general capability, we want agents to be able to install packages by themselves:

Language-specific Package Managers:

• Python: pip, uv
• Node.js (JavaScript/TypeScript: npm or yarn / pnpm
• Ruby: gem
• Java: Maven, Gradle
• Rust: cargo
• Go: go get, go install
• R: Rscript -e "install.packages('<package>')"
• PHP: composer
• .NET (C#): NuGet

System Package Managers:

• Linux (Debian-based): apt
• macOS: brew
• Windows: winget, choco

Agent Features to Include

• Check Before Install: Verify if the package is already installed.
• Version Management: Install specific versions if required.
• Error Handling: Retry failed installs or suggest alternatives.
• Sandbox Mode: Test installs in isolated containers.

Solution

No response

Alternatives

No response

Additional context

No response

[Saedbhati]

#2495

[Wendong-Fan]

Hey @lightaime , regarding package installation, I was wondering if a dedicated toolkit is necessary. Could we integrating this functionality directly into our interpreter module as how @Saedbhati is doing now? Alternatively, what are the specific benefits of keeping it isolated?

[lightaime]

Hi @Wendong-Fan @Saedbhati. I think you are right. However, should we do it in the TerminalToolkit (https://github.com/camel-ai/camel/blob/master/camel/toolkits/terminal_toolkit.py) with TerminalToolkit.shell_exec. Some refactorings for TerminalToolkit may be needed to support sandboxing with docker. Therefore, some design choices may need to consider:

1. Where should we support package installation? TerminalToolkit or CodeExecutionToolkit or both?
2. Should we support docker in TerminalToolkit?
3. Should we support sharing docker container among toolkits such as TerminalToolkit and CodeExecutionToolkit?