The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""One summary of this machine and its OS account, for the desktop first-run onboarding.
Hardware facts come from ``hermes_platform.host``. Account facts (full name, locale) come from OS
user records through ``pwd`` or Win32/CoreFoundation calls, never from environment variables such
as HOME or LANG, and never from a subprocess or the network. They describe the machine that runs
the Hermes backend; when the desktop app drives a remote backend, that is not the user's laptop.
"""
from __future__ import annotations
import functools
import os
import platform
import re
import sys
from hermes_platform.host import facts as host
from hermes_platform.host import products, runtime
# Generic account names that are not a person's name.
_NON_NAMES = frozenset({
"admin", "administrator", "default", "guest", "me", "owner", "root", "test", "user",
})
_HANDLE_CHARS = re.compile(r"[\d_@/\\]")
# --- account facts -----------------------------------------------------------------
def _posix_account() -> tuple[str, str]:
"""Return (login, full name) from the user database."""
import pwd
entry = pwd.getpwuid(os.getuid()) # windows-footgun: ok — only called off Windows (_account)
return entry.pw_name, entry.pw_gecos.split(",", 1)[0].strip()
def _windows_account() -> tuple[str, str]:
"""Return (login, display name) from Win32 account APIs."""
import ctypes
from ctypes import wintypes
login_buf = ctypes.create_unicode_buffer(257)
login_len = wintypes.DWORD(len(login_buf))
login = login_buf.value if ctypes.windll.advapi32.GetUserNameW(login_buf, ctypes.byref(login_len)) else ""
# EXTENDED_NAME_FORMAT NameDisplay = 3. Local accounts without a display name fail here.
name_buf = ctypes.create_unicode_buffer(257)
name_len = wintypes.ULONG(len(name_buf))
full = name_buf.value if ctypes.windll.secur32.GetUserNameExW(3, name_buf, ctypes.byref(name_len)) else ""
return login, full
def _account() -> tuple[str, str]:
try:
return _windows_account() if sys.platform == "win32" else _posix_account()
except (AttributeError, ImportError, KeyError, OSError):
return "", ""
def full_name_from(login: str, full: str) -> str | None:
"""A real full name only; a login handle is never offered as the user's name."""
name = " ".join(full.split())
if not (2 <= len(name) <= 40) or name.lower() in _NON_NAMES or name.lower() == login.lower():
return None
# Digits or underscores ("p14", "CD_01.05") or an all-lowercase cased name mark a handle.
if _HANDLE_CHARS.search(name) or name == name.lower() != name.upper():
return None
return name
def _darwin_locale() -> str:
"""First preferred UI language, e.g. ``de-DE``, via CoreFoundation."""
import ctypes
import ctypes.util
cf = ctypes.CDLL(ctypes.util.find_library("CoreFoundation"))
cf.CFLocaleCopyPreferredLanguages.restype = ctypes.c_void_p
cf.CFArrayGetCount.argtypes = [ctypes.c_void_p]
cf.CFArrayGetCount.restype = ctypes.c_long
cf.CFArrayGetValueAtIndex.argtypes = [ctypes.c_void_p, ctypes.c_long]
cf.CFArrayGetValueAtIndex.restype = ctypes.c_void_p
cf.CFStringGetCString.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.c_long, ctypes.c_uint32]
cf.CFStringGetCString.restype = ctypes.c_bool
cf.CFRelease.argtypes = [ctypes.c_void_p]
languages = cf.CFLocaleCopyPreferredLanguages()
if not languages:
return ""
try:
if cf.CFArrayGetCount(languages) < 1:
return ""
buffer = ctypes.create_string_buffer(64)
# kCFStringEncodingUTF8
if not cf.CFStringGetCString(cf.CFArrayGetValueAtIndex(languages, 0), buffer, 64, 0x08000100):
return ""
return buffer.value.decode()
finally:
cf.CFRelease(languages)
def _windows_locale() -> str:
import ctypes
buffer = ctypes.create_unicode_buffer(85)
return buffer.value if ctypes.windll.kernel32.GetUserDefaultLocaleName(buffer, 85) else ""
def _linux_locale() -> str:
"""System locale from its config file; the shell's LANG is deliberately not read."""
for path in ("/etc/locale.conf", "/etc/default/locale"):
try:
with open(path, encoding="utf-8-sig") as handle:
for line in handle:
key, _, value = line.strip().partition("=")
if key == "LANG" and value:
return value.strip("\"'").split(".", 1)[0].replace("_", "-")
except OSError:
continue
return ""
def _locale() -> str:
try:
if sys.platform == "darwin":
return _darwin_locale()
if sys.platform == "win32":
return _windows_locale()
return _linux_locale()
except (AttributeError, OSError, TypeError, ValueError):
return ""
# --- the summary ----------------------------------------------------------------------
def _machine_kind(os_family: str, nvidia: str | None) -> str:
if nvidia in ("rtx_spark", "dgx_spark"):
return "Spark"
return {"darwin": "Mac", "win32": "PC"}.get(os_family, "computer")
def _os_release(os_family: str) -> str:
# On a Mac platform.release() is the Darwin kernel version (25.x), not the macOS version (26.x).
return (platform.mac_ver()[0] if os_family == "darwin" else "") or platform.release()
@functools.cache
def summary() -> dict:
"""This machine and account as measured. ``machine`` leaves out a key that was not measured;
``locale`` and ``full_name`` are None when the OS has none to give."""
os_family, arch, gpu, cpu = host.os_family(), host.native_arch(), host.gpu_class(), host.cpu_model()
ram = host.ram_total_bytes()
nvidia = products.nvidia_platform()
machine = {
"os_family": os_family,
"os_release": _os_release(os_family),
"native_arch": arch,
"cpu_model": cpu,
"ram_gb": round(ram / 2**30) if ram else None,
"gpu_class": None if gpu == "unknown" else gpu,
"vendor": host.cpu_vendor(),
"wsl": runtime.is_wsl(),
"container": runtime.is_container(),
}
return {
"machine": {key: value for key, value in machine.items() if value not in (None, "")},
"machine_kind": _machine_kind(os_family, nvidia),
"has_nvidia_gpu": gpu == "nvidia",
"nvidia_platform": nvidia,
"locale": _locale() or None,
"full_name": full_name_from(*_account()),
}