Metadata-Version: 2.4
Name: probiotic
Version: 0.3.3
Summary: Autonomous self-improving agent framework for code repositories
Project-URL: Homepage, https://github.com/penthoy/probiotic
Project-URL: Repository, https://github.com/penthoy/probiotic
Project-URL: Issues, https://github.com/penthoy/probiotic/issues
Keywords: agents,automation,cli,symbiont
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Provides-Extra: hive-server
Requires-Dist: fastapi>=0.110; extra == 'hive-server'
Requires-Dist: uvicorn>=0.30; extra == 'hive-server'
Description-Content-Type: text/markdown

# 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:

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

or

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

## CLI

```bash
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

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