plugin-kit-ai-runtime (PyPI authoring helper)
Official Python helper package for launcher-based plugin-kit-ai plugins.
Use it when you want the supported handler-oriented API as a shared dependency instead of generating a local plugin/plugin_runtime.py helper in each repo.
Most teams should start with the default local-helper path first and switch to this package only when they want one reusable helper dependency across multiple repos.
Start Here
Use this package when:
- you want the same helper dependency across multiple plugin repos
- you want to import
plugin_kit_ai_runtimefromrequirements.txtinstead of keeping a generated helper file inplugin/ - you already know that the shared-package path is the right long-term fit
Do not use this package just because it sounds more production-like.
It does not remove the Python runtime requirement from the machine that runs the plugin. If you want the simplest first repo, use the default local-helper path instead.
Fastest Working Setup
Scaffold a Python project directly on the shared-package path:
plugin-kit-ai init my-plugin --platform codex-runtime --runtime python --runtime-package
cd my-plugin
plugin-kit-ai doctor .
plugin-kit-ai bootstrap .
plugin-kit-ai generate .
plugin-kit-ai validate . --platform codex-runtime --strict
plugin-kit-ai test . --platform codex-runtime --event notify
If Claude hooks are your real first requirement, scaffold with --platform claude instead and use:
plugin-kit-ai test . --platform claude --all
If you are testing from a local development build of the CLI instead of a released version, pass --runtime-package-version explicitly during init.
Released stable CLIs pin the matching helper version automatically.
Install:
pip install plugin-kit-ai-runtime
Minimal plugin/main.py
Typical entrypoint when you want this mode from day one:
from plugin_kit_ai_runtime import CodexApp, continue_
app = CodexApp()
@app.on_notify
def on_notify(event):
_ = event
return continue_()
raise SystemExit(app.run())
Keep stdout reserved for tool responses and write diagnostics to stderr only.
Quick Decision Rule
- choose the default local-helper path when you want the smoothest first repo
- choose
plugin-kit-ai-runtimewhen you want one reusable helper dependency across repos - choose Go instead when you want the cleanest packaging and distribution story
Notes
- Go is still the recommended path when you want the most self-contained delivery model.
- Python authoring remains a stable supported lane, but the machine running the plugin still needs Python
3.10+. - The helper API mirrors the generated
plugin/plugin_runtime.pyscaffold surface.
Docs
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file plugin_kit_ai_runtime-1.2.4.tar.gz.
File metadata
- Download URL: plugin_kit_ai_runtime-1.2.4.tar.gz
- Upload date:
- Size: 4.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b55cef55ec2b0a300af92df78bc5ebd37336ca06101968704a4eaff83e072d35
|
|
| MD5 |
8b4ea3df30fcefb58995851d41910c83
|
|
| BLAKE2b-256 |
8114f2a65fd18fe3e341caa9f1435c125747b415ae5b7d07d1f023e1bd06ed95
|
Provenance
The following attestation bundles were made for plugin_kit_ai_runtime-1.2.4.tar.gz:
Publisher:
pypi-runtime-publish.yml on 777genius/plugin-kit-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
plugin_kit_ai_runtime-1.2.4.tar.gz -
Subject digest:
b55cef55ec2b0a300af92df78bc5ebd37336ca06101968704a4eaff83e072d35 - Sigstore transparency entry: 1623980850
- Sigstore integration time:
-
Permalink:
777genius/plugin-kit-ai@9beca10448ac50fbe526a52101d1433a12471980 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/777genius
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-runtime-publish.yml@9beca10448ac50fbe526a52101d1433a12471980 -
Trigger Event:
workflow_run
-
Statement type:
File details
Details for the file plugin_kit_ai_runtime-1.2.4-py3-none-any.whl.
File metadata
- Download URL: plugin_kit_ai_runtime-1.2.4-py3-none-any.whl
- Upload date:
- Size: 4.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d027c73cc65ea80565c7388888f699463728d7b1de2bc15089d08393b0eb8709
|
|
| MD5 |
284ef30ccb1eb8590f2ffe3d099eaa98
|
|
| BLAKE2b-256 |
a8169f53e05bf67bdcf1bf58235a61e80e1604fc2f34b4e631ce8a60e1fbed89
|
Provenance
The following attestation bundles were made for plugin_kit_ai_runtime-1.2.4-py3-none-any.whl:
Publisher:
pypi-runtime-publish.yml on 777genius/plugin-kit-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
plugin_kit_ai_runtime-1.2.4-py3-none-any.whl -
Subject digest:
d027c73cc65ea80565c7388888f699463728d7b1de2bc15089d08393b0eb8709 - Sigstore transparency entry: 1623980858
- Sigstore integration time:
-
Permalink:
777genius/plugin-kit-ai@9beca10448ac50fbe526a52101d1433a12471980 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/777genius
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-runtime-publish.yml@9beca10448ac50fbe526a52101d1433a12471980 -
Trigger Event:
workflow_run
-
Statement type:
