Construya un complemento de tiempo de ejecución Python

Utilice esta ruta cuando su equipo ya escriba Python y desee que el complemento se ejecute desde este repositorio.

Si desea un binario compilado y la historia de distribución más sencilla, elija Go en su lugar. Python es la ruta admitida cuando el repositorio en sí sigue siendo el lugar principal donde se desarrolla y ejecuta el complemento.

Elige tu ruta Python en 10 segundos

Utilice la ruta predeterminada Python cuando desee el primer repositorio más simple:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python

Utilice la ruta del paquete compartido cuando desee importar plugin_kit_ai_runtime desde requirements.txt en varios repositorios:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python --runtime-package

Si no está seguro, comience primero con la ruta predeterminada.

Lo que te brinda este camino

• un repositorio de complementos
• Python 3.10+ en la máquina que ejecuta el complemento
• un local .venv
• un flujo Python admitido para codex-runtime o claude
• una verificación principal antes de confirmar o traspasar: validate --strict

Si solo quieres el camino más corto

Copie esto y llegue a la primera pista verde:

brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai init my-plugin --platform codex-runtime --runtime python
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

Solo cambie a --runtime-package después de que el requisito de dependencia compartida sea real.

1. Instale el CLI

brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai version

2. Proyecto Andamio A Python

Para la ruta normal Python-primera Codex:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python
cd my-plugin

Si los ganchos Claude son el primer requisito real, utilice el andamio Claude en su lugar:

plugin-kit-ai init my-plugin --platform claude --runtime python
cd my-plugin

3. Prepare el entorno local Python

plugin-kit-ai doctor .
plugin-kit-ai bootstrap .

doctor le indica si el repositorio está listo.

bootstrap crea .venv cuando es necesario e instala requirements.txt.

4. Generar y validar

plugin-kit-ai generate .
plugin-kit-ai validate . --platform codex-runtime --strict

generate actualiza el iniciador generado y los archivos de configuración a partir de sus archivos fuente.

Para un primer repositorio Claude, cambie el destino de validación:

plugin-kit-ai validate . --platform claude --strict

5. Agregue su lógica Python

El andamio predeterminado mantiene el asistente local en src/plugin_runtime.py, por lo que la primera versión permanece autónoma.

Forma típica de arranque Codex:

from plugin_runtime import CodexApp, continue_

app = CodexApp()


@app.on_notify
def on_notify(event):
    _ = event
    return continue_()


if __name__ == "__main__":
    raise SystemExit(app.run())

Edite src/main.py para la lógica de su complemento. Mantenga stdout reservado para respuestas de herramientas y escriba diagnósticos solo en stderr.

6. Realice una prueba de humo

Para la ruta de tiempo de ejecución Codex:

plugin-kit-ai test . --platform codex-runtime --event notify

También puedes ejecutar el lanzador generado directamente:

./bin/my-plugin notify '{"client":"codex-tui"}'

Para Claude, la comprobación de humo más sencilla es:

plugin-kit-ai test . --platform claude --all

7. Cuándo utilizar el paquete Python compartido

Manténgase en el asistente local predeterminado cuando desee el primer repositorio más simple.

Utilice la ruta de dependencia compartida cuando desee el mismo paquete auxiliar en varios repositorios:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python --runtime-package

Esa ruta importa plugin_kit_ai_runtime del paquete publicado plugin-kit-ai-runtime en lugar de generar src/plugin_runtime.py.

Si está utilizando una compilación de desarrollo local de CLI de este árbol de fuentes, pase --runtime-package-version explícitamente durante init. Los CLIs estables publicados infieren automáticamente la versión auxiliar correspondiente.

La regla corta

• elija Python cuando el equipo ya esté en Python y el complemento sea local de repositorio
• elija Go cuando desee la historia de embalaje y distribución más limpia
• use doctor -> bootstrap -> generate -> validate --strict como flujo normal Python
• cambie a --runtime-package solo cuando realmente desee una dependencia compartida

Próximos pasos

• Lea Elección del tiempo de ejecución para conocer las compensaciones del tiempo de ejecución.
• Lea Elegir modelo de entrega para conocer la decisión entre ayuda local y paquete compartido.
• Abra Python Runtime API cuando necesite la referencia de ayuda.