systemd-client 0.1.0

High-level Python client for systemd user services: unit management, journal reading, sync + async

systemd-client — High-Level Python Client for systemd User Services

Unified async + sync Python API for systemd unit management and journal reading

API unificada async + sync en Python para gestion de unidades systemd y lectura del journal

---

Choose Your Language / Elige tu idioma

   

---

Architecture Overview

graph TD
    subgraph APP["🐍 Your Application"]
        SYNC["SystemdClient<br/>Synchronous API"]
        ASYNC["AsyncSystemdClient<br/>Async API"]
    end

    subgraph BACKENDS["⚙️ Backends"]
        SUB["🖥️ SubprocessBackend<br/>systemctl --user"]
        DBUS["🔌 DBusBackend<br/>dasbus (optional)"]
    end

    subgraph JOURNAL["📋 Journal Reader"]
        JR["AsyncJournalReader<br/>journalctl --user --output=json"]
    end

    subgraph SYSTEMD["🐧 systemd (user session)"]
        UNITS[("🔧 User Units<br/>services, timers, sockets")]
        JRNL[("📜 Journal<br/>log entries")]
    end

    SYNC --> ASYNC
    ASYNC --> SUB
    ASYNC --> DBUS
    ASYNC --> JR
    SUB --> UNITS
    DBUS --> UNITS
    JR --> JRNL

    style APP fill:#d0ebff,stroke:#1971c2,stroke-width:2px
    style BACKENDS fill:#b2f2bb,stroke:#2f9e44,stroke-width:2px
    style JOURNAL fill:#f3d9fa,stroke:#9c36b5,stroke-width:2px
    style SYSTEMD fill:#fff3bf,stroke:#f08c00,stroke-width:2px
    style SYNC fill:#d0ebff,stroke:#1971c2,stroke-width:2px
    style ASYNC fill:#d0ebff,stroke:#1971c2,stroke-width:2px
    style SUB fill:#b2f2bb,stroke:#2f9e44,stroke-width:2px
    style DBUS fill:#b2f2bb,stroke:#2f9e44,stroke-width:2px
    style JR fill:#f3d9fa,stroke:#9c36b5,stroke-width:2px
    style UNITS fill:#fff3bf,stroke:#f08c00
    style JRNL fill:#fff3bf,stroke:#f08c00

Quick Start

# Install
pip install systemd-client

# Install with DBus backend support
pip install systemd-client[dbus]

# Install with Pydantic models
pip install systemd-client[all]

from systemd_client import SystemdClient

client = SystemdClient()
for unit in client.list_units(unit_type="service"):
    print(f"{unit.name}: {unit.active_state}")

---

systemd-client · github.com/kalexnolasco/systemd-client

© 2026 kalexnolasco