converge
Converge helps groups of independent computer programs work together seamlessly. It provides a way for these programs to find each other, share information, and coordinate their actions without needing a central controller. This is useful for tackling complex tasks that are better handled by many smaller, specialized programs, like managing a large network of sensors or automating a complicated business process. Businesses or researchers who need to build systems from many independent components would find converge helpful. What makes it unique is its ability to manage these interactions in a flexible and decentralized way, allowing for greater resilience and adaptability. It’s still in an early stage of development, so it’s best suited for experimentation and advanced use cases.
README
# converge
> A distributed operating system for agents
`converge` provides the foundational substrate for multi-agent computation: discovery, coordination, and execution so that networks of autonomous agents can operate without central control. It includes core primitives (identity, messages, tasks, pools), transport layers (local and TCP), policy and observability hooks, and an optional file-backed store. **This project is experimental; use at your own risk.**
## Table of Contents
- [Installation](#installation)
- [From Source](#from-source)
- [Development](#development)
- [Documentation](#documentation)
- [License](#license)
## Installation
### From Source
For the latest version:
```bash
git clone https://github.com/gsbm/converge.git
cd converge
pip install -e .
```
### Development
To set up the development environment with test and tooling dependencies:
```bash
git clone https://github.com/gsbm/converge.git
cd converge
pip install -e ".[dev]"
pre-commit install
```
Run tests with:
```bash
pytest -v
```
Optionally use `pytest -v --tb=short` for shorter tracebacks. For coverage (target 98%+; TCP tests require network):
```bash
coverage run -m pytest tests/
coverage report -m --fail-under=98
```
## Documentation
Library documentation is built with [Sphinx](https://www.sphinx-doc.org/) and written in Markdown. To build locally:
```bash
pip install -e ".[docs]"
cd docs && make html
```
Then open `docs/_build/html/index.html` in a browser. Static assets go in `docs/_static/`. See the [documentation index](docs/index.md) for structure and layout.
## License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
PUBLIC HISTORY
IDENTITY
Identity inferred from code signals. No PROVENANCE.yml found.
Is this yours? Claim it →METADATA
README BADGE
Add to your README:
