KOI-net
This protocol and framework are the result of several iterations of KOI research, read more here.
KOI-net (Knowledge Organization Infrastructure Network) can be understood as both a network protocol for distributed knowledge processing, and as a Python framework for building nodes, networks, and applications on top of that protocol. This repo is the implementation of that framework.
For information about the KOI-net protocol, see the official specification.
Quick Start
Installation
(Optionally) create and activate a virtual environment, and install KOI-net:
$ pip install koi-net
Create a Simple Partial Node
The KOI-net framework is built around the dependency injection pattern. Node classes are containers for interdependent components implementing internal subsystems. Each node inherits from a base partial or full node class, which comes with ~36 default components. At a minimum, each node needs to implement a config component:
from koi_net.config import PartialNodeConfig, KoiNetConfig, PartialNodeProfile
class MyPartialNodeConfig(PartialNodeConfig):
koi_net: KoiNetConfig = KoiNetConfig(
node_name="partial",
node_profile=PartialNodeProfile()
)
Which is set in the node container:
from koi_net.core import PartialNode
class MyPartialNode(PartialNode):
config_schema = MyPartialNodeConfig
Finally, the main method can be set to build and run the node:
if __name__ == "__main__":
MyPartialNode().run()
See examples/coordinator.py for a more complex example node, or see the docs for more information on the KOI-net framework.
This framework depends on rid-lib, the Python implementation of the RID protocol.
Documentation
This project uses Sphinx to generate documentation from docstrings. The docs.yml GitHub workflow automatically build and deploys the docs to GitHub Pages. To build the docs locally, run the following command:
$ uv run --extra docs sphinx-build -b html docs docs/_build/html
1 maintainer
Metadata
1 maintainer
Release files for koi-net 2.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| koi_net-2.1.2.tar.gz | 53.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| koi_net-2.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 130.4 kB
Release files / koi_net-2.1.2.tar.gz
| Download URL | koi_net-2.1.2.tar.gz |
|---|---|
| Size | 53.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4c31b0feebcf5a3cee95c26791e688dda0aff5d3f4ba3b3c293befda5abc60c9
|
|
BLAKE2b-256 checksum How to use checksums |
53832a19deb18ac401c924f97346f6c1a652feb7150757aa5c6f20ad5e37284c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 6, 2026.
Transparency logRelease files / koi_net-2.1.2-py3-none-any.whl
| Download URL | koi_net-2.1.2-py3-none-any.whl |
|---|---|
| Size | 77.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df73ca848ea5a65b80746c22e640d0e2f283257d7d068f62b1f1997d0bf16378
|
|
BLAKE2b-256 checksum How to use checksums |
425b219e719c6c5d48d27d3e9b0b7214994ea6e2be5c0751d8e98c393a471acc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 6, 2026.
Transparency log
