Metadata-Version: 2.5
Name: heinzel
Version: 0.9.9
Summary: Heinzelmännchen: an open-source, AI-driven operating system for product development teams.
Project-URL: Homepage, https://helmut.hoffer-von-ankershoffen.me/heinzel/
Project-URL: Documentation, https://helmut.hoffer-von-ankershoffen.me/heinzel/guides/install/
Project-URL: Source, https://github.com/helmut-hoffer-von-ankershoffen/heinzel
Project-URL: Changelog, https://github.com/helmut-hoffer-von-ankershoffen/heinzel/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/helmut-hoffer-von-ankershoffen/heinzel/issues
Author-email: Helmut Hoffer von Ankershoffen <helmuthva@gmail.com>
License-Expression: MIT
License-File: ATTRIBUTIONS.md
License-File: LICENSE
Keywords: agents,cli,pluggy,product-development,typer,workflows
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: croniter>=6.2.4
Requires-Dist: fastapi>=0.161
Requires-Dist: keyring>=25.6
Requires-Dist: mcp>=2.3
Requires-Dist: packaging>=25.0
Requires-Dist: platformdirs>=4.5
Requires-Dist: pluggy<2,>=1.6.0
Requires-Dist: psutil==7.2.2
Requires-Dist: pydantic-ai-slim==2.61.0
Requires-Dist: pydantic-settings<3,>=2.11.0
Requires-Dist: pydantic<3,>=2.12.0
Requires-Dist: pyyaml<7,>=6.0.2
Requires-Dist: rich>=14.2.0
Requires-Dist: tomlkit>=0.13
Requires-Dist: typer>=0.23.0
Requires-Dist: uvicorn>=0.54
Requires-Dist: wsproto>=1.3
Provides-Extra: anthropic
Requires-Dist: pydantic-ai-slim[anthropic]==2.61.0; extra == 'anthropic'
Provides-Extra: openai
Requires-Dist: pydantic-ai-slim[openai]==2.61.0; extra == 'openai'
Description-Content-Type: text/markdown

# Heinzelmännchen

**Less busywork. More good work.** Open-source, local-first helpers for product teams.
Connect your tools, put repeatable work into workflows, and keep people in control.

![Heinzelmännchen helpers](https://raw.githubusercontent.com/helmut-hoffer-von-ankershoffen/heinzel/main/docs/assets/pypi-hero.png)

[Install & explore](https://helmut.hoffer-von-ankershoffen.me/heinzel/guides/install/) ·
[Plugin catalog](https://helmut.hoffer-von-ankershoffen.me/heinzel/CATALOG/) ·
[Build a plugin](https://helmut.hoffer-von-ankershoffen.me/heinzel/PLUGIN_AUTHORING/)

## Install

Supported on **macOS and Linux**. Windows may work, but is not supported.
If you already have [uv](https://docs.astral.sh/uv/getting-started/installation/), run:

<!-- install:start -->
<!-- docs-test -->
```sh
uvx heinzel@latest
```
<!-- install:end -->

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

<!-- install-script:start -->
```sh
curl -LsSf https://helmut.hoffer-von-ankershoffen.me/heinzel/install.sh | sh
```
<!-- install-script:end -->

It reuses uv when available, otherwise runs [Astral's official installer](https://docs.astral.sh/uv/getting-started/installation/).
It then runs the same app launcher. No administrator access or separate Python installation is needed.
You can [inspect the script](https://github.com/helmut-hoffer-von-ankershoffen/heinzel/blob/main/docs/install.sh) 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 Heinzel workspace with fictional data](https://raw.githubusercontent.com/helmut-hoffer-von-ankershoffen/heinzel/main/docs/assets/website/product-workspace.jpg)

This is the foundation: kernel, heads, workflows and extension points. The broader vision is an accountable,
composable AI operating system for product teams. [See the vision and architecture](https://helmut.hoffer-von-ankershoffen.me/heinzel/VISION/).

## 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](https://helmut.hoffer-von-ankershoffen.me/heinzel/PLUGIN_AUTHORING/) covers
scaffolding, local preview, tests, builds, publication and catalog discovery.

For a minimal SDK without the standard plugins:

```sh
uv tool install heinzel
```

[Contribute](https://helmut.hoffer-von-ankershoffen.me/heinzel/guides/contribute/) ·
[Source](https://github.com/helmut-hoffer-von-ankershoffen/heinzel) ·
[Issues](https://github.com/helmut-hoffer-von-ankershoffen/heinzel/issues) ·
[License](https://github.com/helmut-hoffer-von-ankershoffen/heinzel/blob/main/LICENSE)
