host-inspector 0.2.4

A simple python package to gather host information from Windows, Mac and Linux. Returns host data as dicts to be used internally or sent to front-end dashboard applications as JSON.

Host Info

Overview

A simple python package to gather host information from Windows, Mac and Linux. Returns host data as dicts to be used internally or sent to front-end dashboard applications as JSON.

Installation

Install Host Info:

uv add host-inspector
# via pip
python3 -m pip install host-inspector

Development

To get a list of all commands with descriptions simply run make.

make env
make pip_install_editable

Testing

make pytest
make coverage
make open_coverage

Issues

If you experience any issues, please create an issue.

Example Usage

from host_inspector import get_device_info
from host_inspector import get_health_info

print(get_device_info())
print(get_health_info())

# You can also call individual methods:
from host_inspector import get_cpu_info
from host_inspector import get_datetime_info
from host_inspector import get_disk_info
from host_inspector import get_gpu_info
from host_inspector import get_mem_info
from host_inspector import get_network_info
from host_inspector import get_os_info
from host_inspector import get_platform_info
from host_inspector import get_uptime_info

Use with Caution!

To access system services we need to allow passwordless use of specific executables. You should know the security implications of doing this so use at your own risk.

Linux

Use sudo visudo to add the following lines:

%sudo ALL=(ALL) NOPASSWD: /usr/sbin/ufw
%sudo ALL=(ALL) NOPASSWD: /usr/sbin/dmidecode

Save and exit the file (:wq!). Then do:

History

All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

0.2.4 (2025-11-21)

• CHANGED: Firewall rule enabled will always be a boolean rather than YES/NO on Windows for consistency.
• ADDED: Added tox and tox-uv for testing against multiple versions of python

0.2.3 (2025-10-07)

• CHANGED: Ensure tests pass on Ubuntu (not all data available - yet)

0.2.2 (2025-09-25)

• CHANGED: Standardize date/time formatting for device uptime and local_datetime

0.2.1 (2025-09-23)

• ADDED: Support for getting Linux Firewall status and rules using ufw.

0.2.0 (2025-09-09)

• CHANGED: get_device_info now returns a displays key which is a list of connected displays
• CHANGED: get_gpu_info now returns a list of dicts (one for each GPU)
• ADDED: get_display_info returns a list of dicts (one for each display)
• CHANGED: For backawards compatability, when calling get_device_info, the gpu key will be an object if only one GPU detected.

0.1.1 (2025-09-04)

• ADDED: Support for getting Windows Firewall status and rules

0.1.0 (2025-08-06)

• First release