Skip to main content

HermesBaby

The Software and Systems Engineers' Typewriter

Meant to be the authoring environment to get our work done.

Purpose

Using HermesBaby to Enable Docs-as-Code in Corporate Environments

HermesBaby provides a curated toolbox and clean command-line interface that operationalizes the Docs-as-Code approach across engineering organizations. It is designed to simplify both the authoring experience for engineers and the integration into corporate environments — including CI/CD, documentation portals, and internal security policies.

For document authors, HermesBaby makes Docs-as-Code accessible:

  • Projects are scaffolded from templates in seconds.
  • Authoring happens in the same environment used for code development.
  • Build, preview, and publish commands are cleanly separated and easy to use.
  • Kconfig-based configuration offers clarity and traceability without clutter.

At the same time, HermesBaby is built for integration at scale:

  • It works seamlessly with CI pipelines and version-controlled repositories.
  • It supports custom toolchains and validates external dependencies automatically.
  • It installs and configures required build tools, linters, and extensions — even in headless or air-gapped environments.
  • It ensures predictable and compliant deployments via SSH-based publishing and access control via .htaccess.

HermesBaby doesn't just promote structured authoring — it makes documentation controllable, auditable, and cyber-secure. Its infrastructure-aware design allows teams to:

  • Verify toolchains before use.
  • Lock down deployment keys and paths.
  • Comply with internal policies and regulatory requirements.

By lowering the barrier to entry for engineers while raising the bar on control and compliance, HermesBaby bridges the cultural and technical gap between grassroots Docs-as-Code practices and enterprise-grade documentation workflows.

See also: «Article» Engineering Mechatronic Product Lines using the Docs-as-Code Approach

Installation

While it's possible to install it globally via pip, it's recommended to install it via uv tool to keep your system clean and tidy since hermesbaby brings many Python packages with it.

python3 -m pip install uv
uv tool update-shell

uv tool install hermesbaby

Using pipx is common as well :

python3 -m pip install pipx
pipx ensurepath

python3 -m pipx install hermesbaby

You update it later via:

uv tool update hermesbaby

respectively, in case you work with pipx:

python3 -m pipx upgrade hermesbaby

First usage

Close the gaps by installing the missing tools. You may use the help hermesbaby gave you to do so.

Beside hermesbaby there is a second, shorter alias:

hb

Check environment for prerequisites

hb tools check

Start your first new virtual piece of writing

hb new --list-templates
hb new --template hello some_dir
cd some_dir
hb html-live

CTRL-C.

Start editing

git init .
code .

Click Statusbar / html-live

Apply changes to some docs/*/index.md ... and so on.

Happy coding specifications ;-) "

Development and Testing

Running End-to-End (E2E) Tests

The E2E tests are written using BATS. To run them manually, ensure you have uv installed and run uv sync --all-groups.

# Enable the virtual environment:
uv sync --all-groups
# Set up the development environment after you have cloned the repository:
# a) Windows (in git-bash):
source ./.venv/Scripts/activate
# b) Linux / macOS:
# source ./.venv/bin/activate

# Enter the TDD-Loop:
# 1) Run not all tests but the tests focussing on the feature you want to implement, e.g. for bibliographies:
cd "$(pwd -P)" # Necessary in git-bash on Windows
uv run tests/e2e/bats/bin/bats tests/e2e/test-bibliographies.bats -x --show-output-of-passing-tests
# 2) edit your files
code .
# Go to 1) and repeat until you are happy with the implementation.

# After the 2nd run, you can compare the outputs with using Beyond Compare:
bcomp tests/data/bibliographies/out_1 tests/data/bibliographies/out &

# After you are done, you can run all tests to check if everything is fine:
uv run tests/e2e/bats/bin/bats tests/e2e/ -x

Metadata

Release files for hermesbaby 2026.11.13.55

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hermesbaby 2026.11.13.55
File Size Uploaded Provenance Actions
hermesbaby-2026.11.13.55.tar.gz 104.1 MB Without provenance Details for hermesbaby-2026.11.13.55.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hermesbaby 2026.11.13.55
File Interpreter ABI Platform Actions
hermesbaby-2026.11.13.55-py3-none-any.whl Python 3 none any Details for hermesbaby-2026.11.13.55-py3-none-any.whl

Total release size: 207.4 MB

Release files / hermesbaby-2026.11.13.55.tar.gz

Download URL hermesbaby-2026.11.13.55.tar.gz
Size 104.1 MB
Tags Source
SHA-256 checksum
How to use checksums
42f143ebc4713460b554238ed0bc6d97c27ac0890d56970926685e98f4f688b2
BLAKE2b-256 checksum
How to use checksums
07468587e9edfc05cb5f38e81d7dc24ace01672fe1eaef6a0c4d226a92d566b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / hermesbaby-2026.11.13.55-py3-none-any.whl

Download URL hermesbaby-2026.11.13.55-py3-none-any.whl
Size 103.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
257d325b65abf1be981edde0368403554d310b3aa105ec8299006b32834757f4
BLAKE2b-256 checksum
How to use checksums
7216bc4ec10b00102b0c9137587ebf9166bae50d8f0ecf3d6a6de5194f11fa21
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for hermesbaby 2026.11.13.55

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page