probiotic 0.3.1

Autonomous self-improving agent framework for code repositories

Probiotic

Probiotic is a lightweight runtime for repository-native autonomous agents.

It provides:

• a DNA runtime that installs as a Python package
• repo-local cells under symbiont/cells/
• a nightly scheduler
• optional hive reporting and prompt improvement distribution

Status

This project is currently alpha.

The v2 loop implemented in this repo includes:

• prompt hashing based on shareable prompt text
• passive approval metrics from local run history
• hive prompt snapshot storage
• analyzer-generated prompt patches
• nightly apply_updates() before cell execution

Install

Until the package is published to PyPI, install it from GitHub or from a built wheel:

pip install git+https://github.com/penthoy/probiotic.git

or

pip install probiotic-0.1.0-py3-none-any.whl

CLI

probiotic init
probiotic init --self-host
probiotic spawn janitor --template janitor
probiotic doctor
probiotic run-nightly
probiotic connect-hive http://<host>:8000 --api-key <key>
probiotic update-check
probiotic install-worker

probiotic install-worker adds a low-cost cron watchdog for the resident Hive job worker. The worker uses outbound long polling, so dashboard jobs reach an online host in a few seconds without opening an inbound port.

Use probiotic init --self-host only when the current repository is hosting Probiotic itself. Self-host mode injects a host safety policy into every cell, enforces protected control-plane paths, and expects the CLI to run from an installed wheel or tool environment outside the repo checkout. Run probiotic doctor before scheduling cells on a self-hosted repo.

Development

uv sync --extra dev --extra hive-server
uv run pytest
uv build