Skip to content

Repository files navigation

Developers Toolbox

sysinfo

Cross-platform system inventory with modular collectors, redaction, and JSON/YAML/XML/HTML reports.

Documentation · GitHub

Install

pip install lupaxa-sysinfo
sysinfo --help

Features

  • Lightweight defaults: basic host info as pretty-printed JSON
  • Opt-in collectors: CPU, memory, disks, network, listening ports, processes, firewall, runtimes, GPU, packages
  • Granular redaction for hosts, users, IPs, secrets, domains, and custom regexes
  • Profiles for common workflows: minimal, ci, support
  • JSON, YAML, XML, human summary, and compact HTML output (CLI)

Requirements

  • Python 3.10+
  • Runtime: psutil (plus distro on Linux; tldextract for PSL-aware redaction)

Library quick start

from lupaxa.sysinfo import collect_report

report = collect_report(cpu=True, memory=True)

Reports are plain dictionaries with schema_version and tool_version keys, ready for JSON serialisation. See the documentation for CollectOptions, RedactOptions, and profiles.

CLI quick start

sysinfo --version
sysinfo --profile ci --json report.json
sysinfo --all --yaml report.yaml
sysinfo --all --output xml
sysinfo --profile support --xml report.xml

You can also run the CLI as a module:

python -m lupaxa.sysinfo --help
python -m lupaxa.sysinfo --profile ci --json out.json

Development

From a clone of this repository:

make init                # first-time makefile-skills checkout
make python-install-dev  # editable install with [dev]
make python-check        # lint, type-check, and test
make mkdocs-serve        # after skills are installed

Community standards (code of conduct, contributing, security) are in docs/.

The Lupaxa Project Footer

About

Cross-platform system inventory CLI with modular collectors, redaction, and JSON/HTML reports

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages