xcl-lens

RCCL/NCCL log parser and analyzer.

Installation

From PyPI

Using pipx (recommended for CLI use)

pipx install xcl-lens

Using uv

uv tool install xcl-lens

Using pip

pip install xcl-lens

From Source

Using pipx

pipx install .

Using uv

# Install in editable mode
uv pip install -e .

# Or using uv's native install
uv tool install .

Using pip

pip install -e .

Usage

As a Wrapper

mpirun -np 4 xcl-lens \
    ./build/all_reduce_perf -b 4 -e 2G -f 2 -w 3 -n 3 -g 1

Process an Existing File

xcl-lens rccl-log.txt
cat rccl-log.txt | xcl-lens

Options

--summary is used to suppress the raw log. -v is used to extend summary reports.

Development

make setup    # Set up development environment
make format   # Auto-fix and format code (ruff)
make lint     # Check code style and errors (ruff)
make test     # Run all unit tests (pytest)
make build    # Build wheel and sdist into dist/
make clean    # Remove build caches and the virtual environment

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xcl_lens-0.1.12.tar.gz (48.1 kB view details)

Uploaded Jun 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

xcl_lens-0.1.12-py3-none-any.whl (12.1 kB view details)

Uploaded Jun 23, 2026 Python 3

File details

Details for the file xcl_lens-0.1.12.tar.gz.

File metadata

Download URL: xcl_lens-0.1.12.tar.gz
Upload date: Jun 23, 2026
Size: 48.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for xcl_lens-0.1.12.tar.gz
Algorithm	Hash digest
SHA256	`6014656452cb1c6e1f8169bb586549d0e234cf84b07fd80bc605ddaf721d8bff`
MD5	`f2421373a5337ae9a06346f45bf83cf9`
BLAKE2b-256	`b6b409ebe16e3ea31f60f234e19fd112110eeb00a1461dc59de2038d8416122c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for xcl_lens-0.1.12.tar.gz:

Publisher: xcl-lens-publish.yml on alephpiece/hg-misc-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: xcl_lens-0.1.12.tar.gz
- Subject digest: 6014656452cb1c6e1f8169bb586549d0e234cf84b07fd80bc605ddaf721d8bff
- Sigstore transparency entry: 1922893375
- Sigstore integration time: Jun 23, 2026
Source repository:
- Permalink: alephpiece/hg-misc-tools@3a35e61035d2b0a449bb43ce7628acc250c6b508
- Branch / Tag: refs/tags/xcl-lens-0.1.12
- Owner: https://github.com/alephpiece
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: xcl-lens-publish.yml@3a35e61035d2b0a449bb43ce7628acc250c6b508
- Trigger Event: push