docs: add PyPI install and upgrade guide

- Make pip install hermes-pmxt the primary setup path
- Add simple verify, skill install, upgrade, and development sections
- Add PyPI project URLs for homepage, repository, and issues

Author: 0xharryriddle

README.md

@@ -17,33 +17,51 @@ Agent: "The market implies a 1.9% chance (No: 98.1%). Polymarket is pricing this
 
 ## Installation
 
-Install directly with `pip`, matching the one-command style used by Hermes plugins such
-as Mnemosyne. You do not need to clone this repository unless you are developing it.
+The PyPI package is live. For most users, this is the whole install:
 
 ```bash
-pip install "git+https://github.com/0xharryriddle/hermes-pmxt.git"
+pip install hermes-pmxt
 ```
 
-For local development from a checkout:
+Verify it works:
 
 ```bash
-python3 -m venv .venv
-source .venv/bin/activate
-pip install -e ".[dev]"
+python3 -c "from hermes_pmxt import pmxt_runtime_status; print(pmxt_runtime_status())"
 ```
 
 ### Hermes Skill Setup
 
-After installing the package, copy or symlink `skill/SKILL.md` into your Hermes skills
-directory so agents know when and how to use the tools. Example:
+Install the Hermes skill file so your agent knows when to use the package:
 
 ```bash
 mkdir -p ~/.hermes/skills/pmxt
-cp skill/SKILL.md ~/.hermes/skills/pmxt/SKILL.md
+curl -fsSL https://raw.githubusercontent.com/0xharryriddle/hermes-pmxt/main/skill/SKILL.md \
+  -o ~/.hermes/skills/pmxt/SKILL.md
 ```
 
-If your Hermes install supports GitHub-backed skill/plugin installation, point it at
-`https://github.com/0xharryriddle/hermes-pmxt` and enable the `pmxt` skill.
+If your Hermes install supports GitHub-backed skill/plugin installation, use:
+
+```text
+https://github.com/0xharryriddle/hermes-pmxt
+```
+
+### Upgrade
+
+```bash
+pip install --upgrade hermes-pmxt
+```
+
+### Development Install
+
+Only clone the repo if you are modifying hermes-pmxt itself:
+
+```bash
+git clone https://github.com/0xharryriddle/hermes-pmxt.git
+cd hermes-pmxt
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+```
 
 ## Modes
 

pyproject.toml

@@ -9,6 +9,11 @@ dependencies = [
     "pmxt>=2.50.0",
 ]
 
+[project.urls]
+Homepage = "https://github.com/0xharryriddle/hermes-pmxt"
+Repository = "https://github.com/0xharryriddle/hermes-pmxt"
+Issues = "https://github.com/0xharryriddle/hermes-pmxt/issues"
+
 [project.optional-dependencies]
 dev = [
     "pytest>=8.0",

skill/SKILL.md

@@ -26,11 +26,11 @@ arbitrage detection, execution planning, and portfolio inspection.
 
 ## Setup
 
-Install the Hermes integration package directly; it brings in `pmxt>=2.50.0`. Do not
-instruct users to clone the repo unless they are developing the integration.
+Install from PyPI. This brings in `pmxt>=2.50.0`; do not instruct users to clone
+the repo unless they are developing the integration.
 
 ```bash
-pip install "git+https://github.com/0xharryriddle/hermes-pmxt.git"
+pip install hermes-pmxt
 
 # Check runtime status
 python3 -c "from hermes_pmxt import pmxt_runtime_status; print(pmxt_runtime_status())"
@@ -39,9 +39,10 @@ python3 -c "from hermes_pmxt import pmxt_runtime_status; print(pmxt_runtime_stat
 Hosted mode (recommended): set `PMXT_API_KEY` env var. Local sidecar mode works
 without an API key but requires pmxt-core running on localhost:3847.
 
-If Hermes needs an explicit skill install, copy this skill file to
+If Hermes needs an explicit skill install, install this file to
 `~/.hermes/skills/pmxt/SKILL.md` or use your Hermes skill/plugin installer with the
-GitHub URL `https://github.com/0xharryriddle/hermes-pmxt`.
+GitHub URL `https://github.com/0xharryriddle/hermes-pmxt`. Upgrade with
+`pip install --upgrade hermes-pmxt`.
 
 ## Quick Reference