pygubernator 0.0.2

General-purpose Python agent framework with pystator integration

PyGubernator

General-purpose Python agent framework with pystator integration: lifecycle state machines, LLM agents with tools, pipelines, Kafka/in-memory transport, and batch/stream runners.

Install

pip install pygubernator

Optional extras:

pip install pygubernator[llm]      # LiteLLM provider
pip install pygubernator[kafka]    # Kafka transport
pip install pygubernator[charter]   # pycharter
pip install pygubernator[catalyst]  # pycatalyst
pip install pygubernator[all]

Quick start

from pygubernator import Message, InMemoryTransport, run_stream
from pygubernator.agents import PipelineAgent
# … define agents and run run_stream / run_batch with a transport

Configuration

Settings can be loaded from environment variables with the prefix PYGUBERNATOR_, for example:

• PYGUBERNATOR_AGENT_ID
• PYGUBERNATOR_LLM_MODEL
• PYGUBERNATOR_KAFKA_BOOTSTRAP_SERVERS
• PYGUBERNATOR_KAFKA_GROUP_ID (default consumer group name: pygubernator)

Use AgentSettings.from_env() to populate AgentSettings.

Development

make install-dev
make check

Publishing

Version is managed with setuptools-scm. Prefer GitHub tag pushes (e.g. v0.1.0) and Trusted Publishing to PyPI; see .github/workflows/publish.yml and the Makefile publish / publish-test targets.

Rename note

This package was previously developed as pykairos. The PyPI distribution and import package are now pygubernator. Replace imports (import pygubernator), pip install pygubernator, and migrate environment variables from PYKAIROS_* to PYGUBERNATOR_*. The base exception type is GubernatorError (formerly KairosError).