---
id: acryl-datahub-actions
version: "1.7.0.4"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# acryl-datahub-actions — Event-driven action framework for DataHub — trigger automations and workflows in response to real-time metadata changes

License: permissive · Maintenance: active · Downloads: 234.8K/mo

## What it is and what it does

Acryl-datahub-actions is a framework for building event-driven automations on top of DataHub's metadata platform. It connects to Kafka to consume real-time metadata change events (such as tag additions, ownership changes, or entity updates), applies optional filters and transformers to narrow or reshape those events, and then executes custom actions—calling APIs, sending Slack alerts, triggering pipelines, or syncing to external systems. The package is designed to run multiple event pipelines concurrently in a single process, each defined declaratively in YAML.

The framework depends on acryl-datahub as its core metadata client and uses standard Python libraries like click for CLI, pydantic for configuration validation, tenacity for retry logic, and PyYAML for configuration parsing. It targets developers and operators who want to automate responses to metadata changes without building custom integrations from scratch.

Use it for:

- Send Slack notifications when specific tags are added to datasets or when ownership changes occur.
- Automatically sync metadata changes from DataHub to external systems (data catalogs, BI tools, governance platforms).
- Trigger data pipeline runs or quality checks when entities are tagged with specific categories.
- Build custom audit logs or compliance workflows that react to metadata modifications in real time.
- Enrich incoming metadata events with additional context before forwarding them to downstream systems.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Acryl-datahub-actions is an event-driven automation framework that listens to real-time metadata changes in DataHub and triggers custom workflows, notifications, or API calls in response.

Yes, if you are running DataHub and need to automate responses to metadata changes. The package is actively maintained, has low install friction, carries a permissive license, and solves a real operational need. Start with the YAML-based quickstart to evaluate whether the built-in action types meet your use case; if not, the framework supports custom action development.

## Install

pip install acryl-datahub-actions
uv add acryl-datahub-actions
poetry add acryl-datahub-actions

## Installing acryl-datahub-actions

Before you install: Low install friction with a pure Python wheel and no compiled dependencies. Active maintenance with a release on 2026-08-14 and 19 runtime dependencies that are well-established libraries (click, pydantic, tenacity, PyYAML).

License in practice: Apache-2.0 permissive license allows use in commercial and private projects with minimal restrictions; you must include a copy of the license and note any modifications.

Quickstart:

pip install acryl-datahub acryl-datahub-actions

# Define my_action.yml with source (Kafka), filter, and action
datahub actions -c my_action.yml

Requires Python 3.10 or later; a running Kafka broker and DataHub instance are needed for the source and metadata events to flow.

Verify before relying:

- Whether custom action development requires additional dependencies or setup beyond what the package provides.
- Performance characteristics and throughput limits when processing high-volume metadata change events.
- Availability and maturity of built-in action types beyond the 'hello_world' example shown in documentation.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 234.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

event-driven metadata automation, datahub real-time actions, metadata change triggers, datahub workflow automation, kafka event processing datahub, metadata event listener, datahub custom actions framework, metadata-automation, event-driven, datahub-ecosystem

[View on SkillFed](https://skillfed.io/packages/acryl-datahub-actions) · [View on PyPI](https://pypi.org/project/acryl-datahub-actions/)