FreeSDN Plugin Registry
← All plugins

utility

Hello World

A minimal example plugin that demonstrates the FreeSDN Plugin SDK. Lists offline devices, creates alerts, emits events, stores settings, and exposes a custom REST endpoint.

examplesdkstarter

Package

Plugin ID
hello-world
Version
1.1.0
Author
FreeSDN Team
Minimum core
26.06.1
Python
>=3.11
SHA-256
b19c53bd9df6c2b08cc8cbae5110286097b3cb8c98dab1380846c8206522e555

Install

From inside FreeSDN, open Plugins › Marketplace, sync the catalogue, and install Hello World. The instance verifies the catalogue signature before ingest and the archive checksum before unpacking.

To install the archive directly instead:

curl -fSLO https://registry.freesdn.org/dl/hello-world-1.1.0.zip
sha256sum hello-world-1.1.0.zip
# expect: b19c53bd9df6c2b08cc8cbae5110286097b3cb8c98dab1380846c8206522e555

Then upload the ZIP under Plugins › Install from file.

Plugins run in-process with the API. The loader applies import hygiene, ZIP-slip and ZIP-bomb guards, hash-pinned dependencies and per-action permission caps, but it is a cooperative trusted-author model and not a security sandbox. Install what you would be willing to run as application code.

Source and issues →