scitex-container 0.1.2

Unified container management for Apptainer and Docker

scitex-container

Unified container management for Apptainer and Docker

Full Documentation · pip install scitex-container

---

Installation

Requires Python >= 3.10.

pip install scitex-container

With MCP server support (for AI agent integration):

pip install scitex-container[mcp]

Full installation:

pip install scitex-container[all]

CLI Quickstart

# Unified status dashboard
scitex-container status

# Build Apptainer SIF from definition file
scitex-container build --def-name scitex-final

# Version management
scitex-container list
scitex-container switch 2.19.5
scitex-container rollback

# Show all commands
scitex-container --help-recursive

Sandbox Operations

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

Host Package Management

scitex-container host install          # Install TeX Live + ImageMagick
scitex-container host check            # Verify host packages
scitex-container host mounts           # Show configured bind mounts

Docker Operations

scitex-container docker rebuild        # Rebuild Compose services
scitex-container docker restart        # Restart services

Verification & Reproducibility

scitex-container verify                # Verify SIF integrity against lock files
scitex-container env-snapshot          # Capture environment reproducibility snapshot
scitex-container env-snapshot --json   # JSON output for Clew integration

Python API

import scitex_container as sc

# Apptainer container management
sc.apptainer.build(def_name="scitex-final", sandbox=True)
sc.apptainer.list_versions(containers_dir="/opt/containers")
sc.apptainer.switch_version("2.19.5", containers_dir="/opt/containers")
sc.apptainer.rollback(containers_dir="/opt/containers")

# Host package management
sc.host.check_packages()

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

# Environment reproducibility snapshot (Clew integration point)
snapshot = sc.env_snapshot()

Verification API

# Verify container integrity
result = sc.apptainer.verify(sif_path="/opt/containers/scitex-final.sif")
# Returns: {sif, def_origin, pip_lock, dpkg_lock, overall}

# Command builder for scitex-cloud terminal integration
args = sc.apptainer.build_exec_args(
    container_path="/opt/containers/scitex-final.sif",
    username="user01",
    host_user_dir=Path("/data/users/user01"),
    host_project_dir=Path("/data/projects/proj01"),
    project_slug="proj01",
    texlive_prefix="/usr",
)

MCP Server

AI Agent Integration

scitex-container exposes an MCP server so AI agents (Claude, etc.) can manage containers autonomously.

# Start MCP server
scitex-container-mcp

# Install to Claude Code
scitex-container mcp install

Tool	Description
status	Unified container/host status dashboard
build	Build SIF from definition file
list	List available container versions
switch	Switch active container version
rollback	Roll back to previous version
sandbox_create	Create writable sandbox from SIF
docker_rebuild	Rebuild Docker Compose services
host_install	Install host-side packages
env_snapshot	Capture reproducibility snapshot
verify	Verify SIF integrity against lock files

---

AGPL-3.0 — because research infrastructure deserves the same freedoms as the software it runs on.