ansible-rulebook

https://img.shields.io/badge/Maintained%3F-yes-green.svg

https://sonarcloud.io/api/project_badges/measure?project=ansible_ansible-rulebook&metric=coverage

https://codecov.io/gh/ansible/ansible-rulebook/branch/main/graph/badge.svg?token=U1mIB6PI9I

https://github.com/ansible/ansible-rulebook/actions/workflows/ci.yml/badge.svg?branch=main

https://img.shields.io/pypi/pyversions/ansible-rulebook.svg

https://img.shields.io/pypi/v/ansible_rulebook.svg

https://img.shields.io/github/v/release/ansible/ansible-rulebook.svg

https://img.shields.io/github/license/ansible/ansible-rulebook.svg

Free software: Apache Software License 2.0

Event driven automation for Ansible.

The real world is full of events that change the state of our software and systems. Our automation needs to be able to react to those events. Introducing ansible-rulebook; a command line tool that allows you to recognize events that you care about and react accordingly by running a playbook or other actions.

Features

Connect to event streams and handle events in near real time.
Conditionally launch playbooks or Tower’s job templates based on rules that match events in event streams.
Store facts about the world from data in events
Limit the hosts where playbooks run based on event data
Run smaller jobs that run more quickly by limiting the hosts where playbooks run based on event data

Installation

Please follow the Installation guide to install ansible-rulebook.

Documentation

Please refer to the Getting Started guide to get started with ansible-rulebook.

Contributing

We ask all of our community members and contributors to adhere to the Ansible code of conduct. If you have questions or need assistance, please reach out to our community team at codeofconduct@ansible.com

Refer to the Contributing guide to get started developing, reporting bugs or providing feedback.

To find out how to join the community and get in touch, see the Getting in touch section of our docs. You can also find more information in the Ansible communication guide.

Credits

ansible-rulebook is sponsored by Red Hat, Inc.

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ansible_rulebook-1.3.1.tar.gz (335.1 kB view details)

Uploaded Jul 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ansible_rulebook-1.3.1-py3-none-any.whl (126.4 kB view details)

Uploaded Jul 27, 2026 Python 3

File details

Details for the file ansible_rulebook-1.3.1.tar.gz.

File metadata

Download URL: ansible_rulebook-1.3.1.tar.gz
Upload date: Jul 27, 2026
Size: 335.1 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ansible_rulebook-1.3.1.tar.gz
Algorithm	Hash digest
SHA256	`390603f58cda395a9bca06e92ec6f44319a0947e2f7536fb10886a765cec4862`
MD5	`0142d82dc6e4b879721fa55e4b2ea012`
BLAKE2b-256	`5c7d378e899ef2e7456d1faf92893e23fd799c6485d98ee439afe4e8468910d8`

See more details on using hashes here.

File details

Details for the file ansible_rulebook-1.3.1-py3-none-any.whl.

File metadata

Download URL: ansible_rulebook-1.3.1-py3-none-any.whl
Upload date: Jul 27, 2026
Size: 126.4 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ansible_rulebook-1.3.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`32f9aa5fec5bc26a315eb71239b7b75fdc765835b6c5dad41290c4cf85f3a807`
MD5	`08f9e47eec80cfaf9a591aee5f1a4bce`
BLAKE2b-256	`4df9b2e57ac62e15c483918439404f56e51ed99eb769dd0c2da2eada4d945ffe`