1. Overview

hybrid-automaton is a Python framework for modeling, simulating, and executing hybrid automata in both development and real-time control environments. Hybrid automata combine discrete state transitions with continuous dynamics, making them ideal for applications in robotics, autonomous systems, cyber-physical systems, and industrial automation.

This framework provides:

• Dual-mode operation: seamless switching between simulation and real-time sensor-driven execution
• Flexible state representation: supports dictionaries, arrays, or custom objects for continuous states
• Clear separation of concerns: distinguishes integrated continuous states, auxiliary states, and control inputs
• Runtime validation: ensures type and structural consistency of states, transitions, and inputs
• Extensibility: modular architecture with customizable integration methods, guard conditions, reset maps, and lifecycle callbacks

Features

• Definition Framework: A framework for defining a deterministic hybrid automaton via API that programmatically through I language I call (AMDL) Automaton model definition language to perform formal definition.
• Runtime Framework: A full runtime framework for running your defined hybrid automaton in both real time and simulation contexts, utilizing asyncio it runs several tasks including stop monitors state and automaton metadata collectors during automaton run and of course the automaton runner which runs the automaton evaluation loop as defined in the hybrid automaton logic
• Evaluation Module: An extensive suite of modules that contain functionality for generating both qualitative and quantitative information regarding your hybrid automaton’s run for proper evaluation of the automaton you have defined using the framework.
• Integration: Through the use of injectables we can integrate real time sensor data as you please into the loop for the hybrid automaton framework.
• hybrid automatons: There are several hybrid automatons implemented within this package to see examples of different automaton definitions being implemented ran and evaluated utilizing this framework.

2. Installation & Setup

Installation will be simple version 1.0.0 will be released to pypi so you simple need to:

pip install hybrid-automaton==1.0.0

This should install hybrid-automaton alongside all it’s dependencies, please check the README’s in teh github repository for python version dependency but it should work with any version of python >3.8

Getting Started / Quick Start