Downloading the Python Agent

The SeaLights Python agent is published on PyPI and installed via pip. There is no binary to download — the agent and all its dependencies are resolved by the package manager.

Using an internal artifact repository? If your organization mirrors SeaLights agents in an internal repository (such as JFrog Artifactory, Nexus, or alike), replace the download URL with your internal repository endpoint. The download path structure remains the same.

Choosing an Installation Strategy

There are three ways to specify which version to install. Choose based on your stability and operational requirements:

Strategy	When to use
Latest	Quick start, dev/sandbox environments, POC
Specific version ⭐	Production pipelines — set via API (recommended) or hardcoded

The agent depends on the cryptography package, which requires OpenSSL libraries.

• On Linux, this is typically available out of the box.

• On Windows, you may need to install OpenSSL and ensure it is referenced in your LIB and INCLUDE environment variables.

Strategy 1: Install the Latest Version

Installs the most recent published release at runtime. Suitable for development environments where you always want the newest capabilities and can tolerate potential breaking changes between runs.

Bash

echo "[SeaLights] Installing Python agent (latest)..."
pip install sealights-python-agent
echo "[SeaLights] Installed version: $(pip show sealights-python-agent | grep Version)"

GitHub Actions

PowerShell

ADO

Strategy 2: Specific Version (Recommended)

Tip: For production pipelines, leave SL_AGENT_VERSION empty in the snippet below to automatically (via API call) resolve the version your administrator has approved in the Dashboard settings dedicated page.

• When the approved version changes, every pipeline picks it up automatically on the next run — no edits required.

• When troubleshooting, set it to latest or pin it to a specific version (e.g. 2.10.5).

API Endpoint

GET https://{DOMAIN}/api/v2/agents/sealights-python/recommended/version

Authentication: Authorization: Bearer <your-agent-token> Response: JSON object with a version field, e.g. {"version": "2.10.5"}

Bash

SL_DOMAIN="<your-custom-domain>.sealights.co"   # Replace with your account domain
SL_TOKEN=$(cat ./sltoken.txt)                   # Or inject via secret/env var
SL_AGENT_VERSION=""      # "" = resolve from API, "latest" = newest, "X.Y.Z" = pin

PKG_SPEC="sealights-python-agent"
if [ "${SL_AGENT_VERSION}" != "latest" ]; then
  if [ -z "${SL_AGENT_VERSION}" ]; then
    SL_AGENT_VERSION=$(curl -sSf \
      -H "Authorization: Bearer ${SL_TOKEN}" \
      "https://${SL_DOMAIN}/api/v2/agents/sealights-python/recommended/version" \
      | grep -o '"version":"[^"]*"' | cut -d'"' -f4)
  fi
  PKG_SPEC="${PKG_SPEC}==${SL_AGENT_VERSION}"
fi
pip install --quiet "${PKG_SPEC}"
echo "[SeaLights] Installed: $(pip show sealights-python-agent | grep Version)"

GitHub Actions

PowerShell

ADO