iowap-node 2.3.20__py3-none-any.whl

iowap_node-2.3.20.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.5
+Name: iowap-node
+Version: 2.3.20
+Summary: IOWAP Node Framework — daemon, CLI, and handler runner for distributed agent nodes
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.110
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.7
+Requires-Dist: python-multipart>=0.0.18
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: uvicorn[standard]>=0.29
+Requires-Dist: zeroconf>=0.63
+Description-Content-Type: text/markdown
+
+# iowap-node
+
+**IOWAP Node Framework — Build your own node in the IOWAP ecosystem**
+
+> **THIS IS THE REPO YOU WANT** if you want to run a node. Clone this, configure your capabilities, and join the network.
+
+The node framework provides everything you need to register, heartbeat, claim tasks, and run handlers. Nodes are the workers — they advertise what they can do and execute tasks when matched.
+
+## Quick Start (Linux)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/iowap-org/iowap-node/main/install.sh | bash
+```
+
+Manuell (jede Plattform):
+
+```bash
+git clone https://github.com/iowap-org/iowap-node.git
+cd iowap-node
+pip install -e .
+cp relay_config.json.example ~/.relay/relay_config.json
+# edit ~/.relay/relay_config.json
+node-cli node register
+node-cli capabilities publish default
+```
+
+## What You Can Build
+
+A node is just a process that:
+
+1. **Heartbeats** its capabilities to a relay server (what can I do?)
+2. **Claims tasks** that match its capabilities (I'll take this)
+3. **Runs handlers** — scripts or programs — to execute the work
+4. **Completes tasks** with results
+
+Your capabilities are defined in a `node.yaml`:
+
+```yaml
+node_name: "my-notifier"
+node_description: "Sends push notifications"
+capabilities:
+  notification.send:
+    description: "Send a push notification to my phone"
+    type: script
+    input_schema:
+      fields:
+        - name: title
+          type: string
+          required: true
+          description: "Notification title"
+        - name: body
+          type: string
+          required: true
+          description: "Notification body"
+        - name: priority
+          type: string
+          required: false
+          description: "low / normal / high"
+```
+
+Just write a handler script that reads the JSON payload from stdin, calls your push service, and writes the result to stdout. That's it — the node framework handles the rest.
+
+## Components
+
+| Component | Description |
+|-----------|-------------|
+| `node-cli` | CLI tool — register, manage, submit tasks, list nodes |
+| `node-daemon` | Event-driven worker — listens for tasks via SSE, runs handlers |
+| `relay_client` | HTTP client library for relay API |
+| `handler_runner` | Execute custom handlers with stdin/stdout contract |
+| `node_config` | Capability/configuration management |
+
+## CLI Reference
+
+```bash
+node-cli register                  # Register with a relay server
+node-cli capabilities server       # List server-known capabilities
+node-cli capabilities publish      # Publish your capabilities
+node-cli task submit <capability>  # Submit a task
+node-cli task wait <id>            # Wait for task completion
+node-cli node list                 # List registered nodes
+node-cli node info <id>            # Node details
+node-cli daemon                    # Start the daemon (foreground)
+node-cli bridge upload <file>      # Upload via bridge route
+node-cli bridge download <url>     # Download via bridge route
+```
+
+## Docker
+
+A base Docker image is available for containerized nodes:
+
+```bash
+docker pull ghcr.io/iowap-org/iowap-node:latest
+```
+
+See `docker/nodes/base/` for the Dockerfile.
+
+## Docs
+
+Full documentation in [iowap-org/iowap-docs](https://github.com/iowap-org/iowap-docs):
+
+- [getting-started.md](https://github.com/iowap-org/iowap-docs/blob/main/getting-started.md) — first steps
+- [node/setup.md](https://github.com/iowap-org/iowap-docs/blob/main/node/setup.md) — node setup
+- [node/cli.md](https://github.com/iowap-org/iowap-docs/blob/main/node/cli.md) — full CLI reference
+- [node/capabilities.md](https://github.com/iowap-org/iowap-docs/blob/main/node/capabilities.md) — capability definitions
+- [federation/concept.md](https://github.com/iowap-org/iowap-docs/blob/main/federation/concept.md) — cross-relay federation
+
+## License
+
+MIT — see [LICENSE](LICENSE).

iowap_node-2.3.20.dist-info/RECORD

@@ -0,0 +1,28 @@
+nodes/__init__.py,sha256=kF3aMOwup5QR75bjDu7Nzr3QptJ63IsP7pEM_ibDCQ0,53
+nodes/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nodes/common/capability.py,sha256=ez-mlPRUVT7OfVPHkRXBIRFgYzdy8t8D8-aC1Zkjb34,18419
+nodes/common/envelope.py,sha256=qxvkh-CpHFocKNZ24v_GLJpr9Qjh_w0iLVg_QH11Rno,7007
+nodes/common/file_serve.py,sha256=ficWBE5ttEyzTzvExyGOt6Svl8B5Ry75ah3tvNxN3QA,25309
+nodes/common/handler_runner.py,sha256=UTz5E_qhb4RdQ6cR4_rUz_pNC4mk9PAPP1uU95pQFrI,19480
+nodes/common/node_cli.py,sha256=CvrQivxhjM-Oh4A1tELIzS_RVU1PyDOhRsZ5K1ZlAlo,55118
+nodes/common/node_config.py,sha256=yOoC0536Tq3j1x7juamw5Jfh-TgvWb2OStl6zltO84g,32602
+nodes/common/node_daemon.py,sha256=qL4dgkz5uH6d1rS213bZFO4-kqnL8mtxmvHbrYiHXB4,40258
+nodes/common/node_utils.py,sha256=2TxmydRSH0lcTh-rKwJj3n8NVhBmEKg0StsMPQopri0,17429
+nodes/common/relay_client.py,sha256=K7kDZ5RoOT5wRyVfZ8GlIDnor6RN4s4Lm8jjWEdKQuM,52264
+nodes/common/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nodes/common/cli/cli_artifact.py,sha256=fqzkecXiqi_dhn30OHSV87ecRTZx64RMBtdugn8cRjA,1239
+nodes/common/cli/cli_bridge.py,sha256=fF_RG2QEEDcuP7EUX__K9kqRkhOi7LbLaIrFX2NsTQ8,10527
+nodes/common/cli/cli_capabilities.py,sha256=jbQGrCvKPXJ8_lELTd80Dgllr7FSd_nhbUnVkiAOsDA,8246
+nodes/common/cli/cli_docs.py,sha256=SZ7ufr5YQkYPou99wDVOMpJLdj83Vxc9RZtTApPCjbw,4657
+nodes/common/cli/cli_file.py,sha256=pPCz8QPtJ92k-BGwgMB33SWjXV6PT3ZJMxEKsCqDFkU,16658
+nodes/common/cli/cli_hp.py,sha256=02yUR0WqgYeSdtLp0_2CbhRQa18ujw2M-EXZ7H5i4rk,21279
+nodes/common/cli/cli_node.py,sha256=-eTAnM-71HgwPC04NC-V9ST7HPo8pWVK7AJj5kXPH1c,9505
+nodes/common/cli/cli_route.py,sha256=HdRrvUn7yamPrOIyEqIoHN8qR25GT-NwYBPPGZRio48,3116
+nodes/common/cli/cli_server.py,sha256=L6osOAEJVlAw6i8XX-QWN3CCxxL9kVA6xjkk5CiHdrA,8806
+nodes/common/cli/cli_task.py,sha256=N4zceRr7V0Fs2N0psfzx9LVe6ac6DDsGqsskeMflWZA,7246
+nodes/common/cli/cli_update.py,sha256=H6ik_D2G7awMeU_ubIpRI-YgGEDVUsmV47Ex-jE1g7s,1984
+iowap_node-2.3.20.dist-info/METADATA,sha256=SyMIlmow1t6IrwW8OfiSoKDBqCem9V_SEpPWb5u0IZM,4313
+iowap_node-2.3.20.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+iowap_node-2.3.20.dist-info/entry_points.txt,sha256=23OdcxzF4ciidERcrAOUU6ZiEK82mIi_r4pefSBZYY0,100
+iowap_node-2.3.20.dist-info/licenses/LICENSE,sha256=jqWgc-nPTXXB5PYfNCScU8u8c1ixMcrg0SFZLcejJ8c,1068
+iowap_node-2.3.20.dist-info/RECORD,,

iowap_node-2.3.20.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

iowap_node-2.3.20.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+node-cli = nodes.common.node_cli:main
+node-daemon = nodes.common.node_daemon:main

iowap_node-2.3.20.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2026 iowap-org
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nodes/__init__.py

@@ -0,0 +1 @@
+# IOWAP Node — Package namespace for `nodes.common`