Swarmauri Example Plugin
The Swarmauri Example Plugin is a lightweight reference package that shows how to ship a plugin ready for the Swarmauri ecosystem. It demonstrates how to declare entry points, surface metadata, and structure tests so that new plugin projects start from a fully configured baseline that supports Python 3.10 through 3.12.
Features
- Entry-point wiring – exposes the
swarmauri.pluginsgroup so your agent classes can be discovered automatically once implemented. - Ready-to-publish metadata – includes keywords, classifiers, and long
descriptions wired directly into
pyproject.toml. - Version helpers – surfaces
__version__and__long_desc__constants so documentation and tooling can introspect the package after installation. - Testing scaffold – ships with baseline unit tests verifying version resolution to encourage a test-first development workflow.
Installation
Using uv
uv add swm-example-plugin
Using pip
pip install swm-example-plugin
Usage
Inspect published metadata
from swm_example_plugin import __long_desc__, __version__
print(__version__)
print(__long_desc__.splitlines()[0])
Discover the registered entry point
from importlib.metadata import entry_points
for ep in entry_points(group="swarmauri.plugins"):
if ep.name == "example_agent":
print(ep.name, "->", ep.value)
break
This skeleton intentionally leaves the actual agent implementation up to you. Replace the target specified in the entry point with your concrete class to wire custom functionality into the Swarmauri plugin registry.
Project Resources
- Source: https://github.com/swarmauri/swarmauri-sdk/tree/main/pkgs/plugins/example_plugin
- Documentation: https://github.com/swarmauri/swarmauri-sdk/tree/main/pkgs/plugins/example_plugin#readme
- Issues: https://github.com/swarmauri/swarmauri-sdk/issues
- Releases: https://github.com/swarmauri/swarmauri-sdk/releases
- Discussions: https://github.com/orgs/swarmauri/discussions
1 maintainer
Metadata
1 maintainer
Release files for swm_example_plugin 0.6.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| swm_example_plugin-0.6.5.tar.gz | 6.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| swm_example_plugin-0.6.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.5 kB
Release files / swm_example_plugin-0.6.5.tar.gz
| Download URL | swm_example_plugin-0.6.5.tar.gz |
|---|---|
| Size | 6.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7867dd74bf797d3b53dab5df9afc49c0c3dae2d6bf7d6b3a65119f1cf203d7da
|
|
BLAKE2b-256 checksum How to use checksums |
bf7f64e2f8b278f2bb4f351d5db1063bea16b7b4e69c70cf06042bd73756d0cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / swm_example_plugin-0.6.5-py3-none-any.whl
| Download URL | swm_example_plugin-0.6.5-py3-none-any.whl |
|---|---|
| Size | 7.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb5e9d32d8d2aede47b61e6ab182ef033768b90a8dce8ac5df06dcf353c43b50
|
|
BLAKE2b-256 checksum How to use checksums |
fe703ccdf5b4ac112b8ef052ff1f6b76ed48966b48f02b90c911b81215b7d296
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
