# hello-python

> Minimal Python worker — hello-python::greet returns a greeting and fires hello-python::greeted.

| field | value |
|-------|-------|
| version | 0.1.11 |
| type | bundle |
| license | Apache-2.0 |
| author | Anthony (iii) |

## installation

```sh
iii trigger compose::add worker=hello-python@0.1.11
```

## readme

# hello-python

Minimal Python worker for iii.

- `hello-python::greet` — `{ name }` → `{ message }`, then fires `hello-python::greeted`.
- `hello-python::stats` — how many greetings it answered.
- Trigger type `hello-python::greeted` — bind a function to it (optionally `{ name }` to filter) to receive
  `{ name, message }` after every greeting.

```sh
iii trigger compose::add worker=hello-python
iii trigger hello-python::greet name=iii
```

## skills

This version ships 1 skill file for agents, also browsable on the worker page:

- [`SKILL.md`](https://workers.iii.dev/workers/hello-python?tab=skills&skill=SKILL.md&version=0.1.11)

### SKILL.md

# hello-python

Greets people. Call `hello-python::greet` with `{ "name": "<who>" }`; it answers `{ "message": "Hello, <who>!" }`.
Bind a function to the `hello-python::greeted` trigger type to be told about every greeting.

## api reference

```json
{
  "functions": [
    {
      "description": "Return a greeting for `name` and fire hello-python::greeted.",
      "metadata": {},
      "name": "hello-python::greet",
      "request_schema": {
        "properties": {
          "name": {
            "description": "Who to greet",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "response_schema": {
        "properties": {
          "message": {
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "type": "object"
      }
    },
    {
      "description": "How many greetings this worker answered since it started.",
      "metadata": {},
      "name": "hello-python::stats",
      "request_schema": {
        "properties": {},
        "type": "object"
      },
      "response_schema": {
        "properties": {
          "greeted": {
            "description": "Greetings answered",
            "type": "integer"
          }
        },
        "required": [
          "greeted"
        ],
        "type": "object"
      }
    }
  ],
  "triggers": [
    {
      "description": "Fires after hello-python::greet answers, with the greeting.",
      "invocation_schema": {
        "properties": {
          "name": {
            "description": "Only fire for greetings to this name.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "metadata": {},
      "name": "hello-python::greeted",
      "return_schema": {
        "properties": {
          "message": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "message"
        ],
        "type": "object"
      }
    }
  ]
}
```
