Quickstart

CLI Quickstart

Check container status across Apptainer and Docker:

scitex-container status

Build an Apptainer SIF from a definition file:

scitex-container build --def-name scitex-final

List available container versions:

scitex-container list

Switch active container version:

scitex-container switch 2.19.5

Create a writable sandbox from a SIF:

scitex-container sandbox create --sif scitex-final.sif

Install host-side dependencies (TeX Live, ImageMagick):

scitex-container host install

Rebuild Docker Compose services:

scitex-container docker rebuild

Python API Quickstart

import scitex_container as ctr

# Apptainer operations
ctr.apptainer.build(def_name="scitex-final", sandbox=True)
ctr.apptainer.switch_version("2.19.5", containers_dir="/opt/containers")
versions = ctr.apptainer.list_versions(containers_dir="/opt/containers")
status = ctr.apptainer.status()

# Reproducible build round-trip
result = ctr.apptainer.build_reproducible(
    layer="sac-base",
    root="/opt/containers",
    def_name="apptainer-base",
)
print(f"Verified: {result.verified}")

# Use-time verify gate
ctr.apptainer.check_verified("/opt/containers/sac-base.sif")

# Host operations
ctr.host.check_packages()

# Docker operations
ctr.docker.rebuild(env="prod")

# Environment snapshot
snapshot = ctr.env_snapshot()

MCP Server Quickstart

Start the MCP server for AI agent integration:

scitex-container-mcp

Install to Claude Code:

scitex-container mcp install