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.10.18.54

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.10.18.54
File Size Uploaded Provenance Actions
hermesbaby-2026.10.18.54.tar.gz 104.1 MB Without provenance Details for hermesbaby-2026.10.18.54.tar.gz

Built distribution (wheel)

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

Total release size: 207.4 MB

Release files / hermesbaby-2026.10.18.54.tar.gz

Download URL hermesbaby-2026.10.18.54.tar.gz
Size 104.1 MB
Tags Source
SHA-256 checksum
How to use checksums
9e351a9a0e669c42f40c988334edcd0fbc77d75cb7131166c869420666274f8e
BLAKE2b-256 checksum
How to use checksums
324669b0b4251fc6af7dcc73d29285e2892ea4e317b6541b15fe4a44febc479a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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.10.18.54-py3-none-any.whl

Download URL hermesbaby-2026.10.18.54-py3-none-any.whl
Size 103.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
e3e724b151ba451184643727fc270f54b12664b189bbdcd87a6ee52e44180787
BLAKE2b-256 checksum
How to use checksums
89d9b57b0ec924791f7e151c7ff056e98e1359ea392edfab9a40d369ccf85b24
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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.10.18.54

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