sbx/smolagents-kit:20260820-60c747130ba7b8355c692757d17c99ef0d478516

schemaVersion: "2"
kind: mixin
name: smolagents
displayName: smolagents
description: Installs Hugging Face smolagents in an isolated Python virtual environment and exposes the smolagent and webagent CLIs inside the sandbox.
permissions:
    network:
        allow:
            - pypi.org:443
            - files.pythonhosted.org:443
            - huggingface.co:443
            - hf.co:443
            - router.huggingface.co:443
            - duckduckgo.com:443
            - html.duckduckgo.com:443
            - www.duckduckgo.com:443
            - archive.ubuntu.com:80
            - security.ubuntu.com:80
            - ports.ubuntu.com:80
            - download.docker.com:443
environment:
    variables:
        SMOLAGENTS_PYTHON: /opt/smolagents/bin/python
        SMOLAGENTS_VENV: /opt/smolagents
setup:
    install:
        - command: apt-get update && apt-get install -y --no-install-recommends ca-certificates python3 python3-venv python3-pip && rm -rf /var/lib/apt/lists/*
          user: "0"
          description: Install Python and venv prerequisites for smolagents
        - command: |
            set -euo pipefail
            SMOLAGENTS_VERSION=1.26.0
            python3 -m venv /opt/smolagents
            /opt/smolagents/bin/python -m pip install --upgrade pip setuptools wheel
            /opt/smolagents/bin/python -m pip install "smolagents[toolkit,vision]==${SMOLAGENTS_VERSION}"
            ln -sf /opt/smolagents/bin/smolagent /usr/local/bin/smolagent
            ln -sf /opt/smolagents/bin/webagent /usr/local/bin/webagent
            cat > /usr/local/bin/smolagents-python <<'SCRIPT'
            #!/bin/sh
            exec /opt/smolagents/bin/python "$@"
            SCRIPT
            chmod 0755 /usr/local/bin/smolagents-python
            smolagent --help >/dev/null
            webagent --help >/dev/null
            smolagents-python -c 'import smolagents; print("smolagents", smolagents.__version__)'
          user: "0"
          description: Install smolagents v1.26.0 with toolkit and vision extras in /opt/smolagents
        - command: |
            set -euo pipefail
            grep -qF 'smolagents-python' ~/.bashrc 2>/dev/null || \
              printf '\n# smolagents (added by sbx-kits-contrib/smolagents)\nexport SMOLAGENTS_VENV=/opt/smolagents\nexport SMOLAGENTS_PYTHON=/opt/smolagents/bin/python\nalias smolagents-python=/opt/smolagents/bin/python\n' >> ~/.bashrc
          user: "1000"
          description: Add smolagents helper environment variables to interactive shells