usepaxterapp 0.1.0__tar.gz

usepaxterapp-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: usepaxterapp
+Version: 0.1.0
+Summary: Paxter connector for Hermes — bridges your Hermes agent to the Paxter app over an end-to-end-encrypted relay. Outbound-only: nothing is exposed on your machine.
+Author: Paxter
+Keywords: hermes,hermes-agent,paxter,plugin,platform,agent
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: paho-mqtt>=1.6
+Requires-Dist: pynacl>=1.5
+
+# Paxter connector (Hermes plugin)
+
+Connects your self-hosted [Hermes Agent](https://hermes-agent.nousresearch.com) to the **Paxter** mobile app — privately, with nothing exposed on your machine.
+
+It runs as a Hermes **platform plugin** inside your `hermes gateway`: it dials *out* to the Paxter relay (MQTT over TLS), so there's no inbound port, no public URL, and no tunnel to set up. Works behind NAT, on a VPS, or over SSH/tmux.
+
+## Install
+
+```bash
+pip install usepaxterapp
+hermes plugins enable paxter
+hermes config set platforms.paxter.extra.pairing_code <CODE>   # from the Paxter app
+hermes gateway restart
+```
+
+`pip install usepaxterapp` pulls the package from PyPI; Hermes auto-discovers it
+via the `hermes_agent.plugins` entry point, and `hermes plugins enable paxter`
+turns it on. In the Paxter app: **Connect → Hermes** to get your one-time pairing
+code. Update later with `pip install --upgrade usepaxterapp`.
+
+## How it works
+
+```
+Paxter app → paxter-gateway (backend) → MQTT broker → this plugin → your Hermes agent
+```
+
+- The plugin trades the one-time pairing code for a short-lived **JWT** (scoped by the broker to only your own topics) and a broker URL, cached in `~/.hermes/paxter/connection.json`.
+- Incoming app messages arrive on `paxter/{userId}/{connectorId}/req`; the plugin dispatches them to your local agent and publishes replies on `.../res`.
+- The agent runs on **your** machine and **your** model bill — Paxter never sees your agent's key.
+
+## Security
+
+- Outbound-only: no inbound port is opened.
+- The JWT pins this connector to its own two topics — it can never read another user's traffic.
+- Revocable from the Paxter app (the backend refuses to re-issue the JWT).
+
+## Files
+- `pyproject.toml` — PyPI packaging + the `hermes_agent.plugins` entry point.
+- `usepaxterapp/__init__.py` — exposes `register(ctx)` (the plugin entry point).
+- `usepaxterapp/adapter.py` — the `BasePlatformAdapter` implementation (MQTT bridge).

usepaxterapp-0.1.0/README.md

@@ -0,0 +1,40 @@
+# Paxter connector (Hermes plugin)
+
+Connects your self-hosted [Hermes Agent](https://hermes-agent.nousresearch.com) to the **Paxter** mobile app — privately, with nothing exposed on your machine.
+
+It runs as a Hermes **platform plugin** inside your `hermes gateway`: it dials *out* to the Paxter relay (MQTT over TLS), so there's no inbound port, no public URL, and no tunnel to set up. Works behind NAT, on a VPS, or over SSH/tmux.
+
+## Install
+
+```bash
+pip install usepaxterapp
+hermes plugins enable paxter
+hermes config set platforms.paxter.extra.pairing_code <CODE>   # from the Paxter app
+hermes gateway restart
+```
+
+`pip install usepaxterapp` pulls the package from PyPI; Hermes auto-discovers it
+via the `hermes_agent.plugins` entry point, and `hermes plugins enable paxter`
+turns it on. In the Paxter app: **Connect → Hermes** to get your one-time pairing
+code. Update later with `pip install --upgrade usepaxterapp`.
+
+## How it works
+
+```
+Paxter app → paxter-gateway (backend) → MQTT broker → this plugin → your Hermes agent
+```
+
+- The plugin trades the one-time pairing code for a short-lived **JWT** (scoped by the broker to only your own topics) and a broker URL, cached in `~/.hermes/paxter/connection.json`.
+- Incoming app messages arrive on `paxter/{userId}/{connectorId}/req`; the plugin dispatches them to your local agent and publishes replies on `.../res`.
+- The agent runs on **your** machine and **your** model bill — Paxter never sees your agent's key.
+
+## Security
+
+- Outbound-only: no inbound port is opened.
+- The JWT pins this connector to its own two topics — it can never read another user's traffic.
+- Revocable from the Paxter app (the backend refuses to re-issue the JWT).
+
+## Files
+- `pyproject.toml` — PyPI packaging + the `hermes_agent.plugins` entry point.
+- `usepaxterapp/__init__.py` — exposes `register(ctx)` (the plugin entry point).
+- `usepaxterapp/adapter.py` — the `BasePlatformAdapter` implementation (MQTT bridge).

usepaxterapp-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "usepaxterapp"
+version = "0.1.0"
+description = "Paxter connector for Hermes — bridges your Hermes agent to the Paxter app over an end-to-end-encrypted relay. Outbound-only: nothing is exposed on your machine."
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [{ name = "Paxter" }]
+keywords = ["hermes", "hermes-agent", "paxter", "plugin", "platform", "agent"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+]
+dependencies = [
+  "paho-mqtt>=1.6",
+  "pynacl>=1.5",
+]
+
+# Hermes discovers pip-installed plugins via this entry-point group
+# (hermes_cli/plugins.py: ENTRY_POINTS_GROUP). `paxter` is the plugin/platform
+# name the user enables (`hermes plugins enable paxter`); the value resolves to
+# the package, whose __init__ exposes register(ctx).
+[project.entry-points."hermes_agent.plugins"]
+paxter = "usepaxterapp"
+
+[tool.setuptools]
+packages = ["usepaxterapp"]

usepaxterapp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

usepaxterapp-0.1.0/usepaxterapp/__init__.py

@@ -0,0 +1,3 @@
+from .adapter import register
+
+__all__ = ["register"]