Skip to main content

Heinzelmännchen

Less busywork. More good work. Heinzelmännchen is an open-source crew of AI helpers that drafts your team's busywork and asks before anything leaves your machine. Connect your tools, put repeatable work into workflows, and keep people in control.

Heinzelmännchen helpers

Install & explore · Plugin catalog · Build a plugin

Install

Supported on macOS and Linux. Windows may work, but is not supported. If you already have uv, run:

uvx heinzel@latest

Need uv installed for you? Use the guided installer instead:

curl -LsSf https://heinzel.team/install.sh | sh

It reuses uv when available, otherwise runs Astral's official installer. It then runs the same app launcher. No administrator access or separate Python installation is needed. You can inspect the script first.

One command selects the newest published standard app, verifies its artifacts, installs its default plugins and opens the workspace. You do not need to choose versions, clone a repository or configure a build environment. Run the same command later to open the installed app. Ctrl-C stops the foreground session; background operation remains optional. Use the setup flow to configure the services you want. Optional integrations may need credentials. Installing the Tailscale plugin does not enable sharing. On Linux, standard installation needs an accessible systemd user manager in your user session. In a headless session without one, open a user session with its service manager and retry.

Work where you work

  • One operation, several ways in. Typed Python operations can become CLI commands, MCP tools and REST endpoints.
  • A web workspace. Today, contracts and team context bring the work into view.
  • Plugins that own their functionality. Add operations, views, widgets, notifications and integrations.
  • Themes with personality. Palettes, artwork and soundscapes belong to their themes.
  • Independent development. Build, test and release plugins against an installed SDK.

Team graph in the Heinzelmännchen workspace with fictional data

This is the foundation: kernel, heads, workflows and extension points. The broader vision is accountable, composable helpers that draft a product team's recurring work for a person's approval. See the vision and architecture.

Extend it

Plugins can live in their own public or private repositories, carry their own dependencies and release on their own schedule. The authoring guide covers scaffolding, local preview, tests, builds, publication and catalog discovery.

For a minimal SDK without the standard plugins:

uv tool install heinzel

Contribute · Source · Issues · License

Metadata

Release files for heinzel 0.9.15

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

Source distribution (sdist)

Source distribution for heinzel 0.9.15
File Size Uploaded Provenance Actions
heinzel-0.9.15.tar.gz 9.1 MB With provenance Details for heinzel-0.9.15.tar.gz

Built distribution (wheel)

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

Total release size: 11.7 MB

Release files / heinzel-0.9.15.tar.gz

Download URL heinzel-0.9.15.tar.gz
Size 9.1 MB
Tags Source
SHA-256 checksum
How to use checksums
6c65c8df6f49860ff7775d96833edf5dc188ded1550438de58b31658e7396a72
BLAKE2b-256 checksum
How to use checksums
2535d9065f61c9367942c355dddba29b8c63f2f54c476a21fdf681a63d63dcbb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Release files / heinzel-0.9.15-py3-none-any.whl

Download URL heinzel-0.9.15-py3-none-any.whl
Size 2.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
bbcaaf457bd9adacf469293881d9edb2c539c40d3cc3191148714238e8afd435
BLAKE2b-256 checksum
How to use checksums
ed31331f330e2afeb9d1d0138f38f3156742ad9852957c0bb5eb08695f330622
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Security for heinzel 0.9.15

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for heinzel-0.9.15.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

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

0.9.15 This release

2 release files Full provenance

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