Skip to content

stare

stare is a Python library and CLI for the CERN ATLAS Glance/Fence API. It provides typed access to analyses, papers, CONF notes, PUB notes, publications, groups, subgroups, and triggers — with OAuth2 PKCE authentication against CERN Keycloak built in.

Actions Status PyPI version

Quick start

python -m pip install stare
stare auth login          # opens CERN SSO in your browser
stare analysis search --limit 10

pixi add stare-atlas
pixi shell
stare auth login          # opens CERN SSO in your browser
stare analysis search --limit 10

from stare import Glance

with Glance() as g:
    result = g.analyses.search(query="referenceCode = ANA-HION-2018-01")
    for a in result.results:
        print(a.reference_code, a.short_title)

uvx stare auth login          # opens CERN SSO in your browser
uvx stare analysis search --limit 10

Features

  • Analyses and papers — search and retrieve ATLAS analyses, papers, CONF notes, and PUB notes
  • Simple query language — filter by reference code, status, leading group, keywords, and more
  • Secure authentication — browser-based CERN SSO login; no passwords stored, tokens refresh automatically
  • CLI and library — Rich tables for interactive use, auto-JSON when piping; full Python API for scripts and notebooks

Ready to install? See Getting started.