# Hermes Agent Upgrade — Session 2026-06-14

## Situation
- Server: Ubuntu 26.04, Python 3.14.4
- Old version: v0.15.2 (PyPI)
- New version: v0.16.0 (2026.6.5) — 1 commit behind on GitHub

## Key Discovery: Python 3.14 Incompatibility
hermes-agent requires `>=3.11,<3.14`. Python 3.14 CANNOT install hermes-agent.
Solution: Use uv to install Python 3.13 in parallel, create a separate venv.

## Exact Commands Used

```bash
# 1. Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"

# 2. Install Python 3.13
uv python install 3.13

# 3. Create venv
uv venv /opt/hermes-dev --python 3.13

# 4. Clone and install dev version
cd /tmp && git clone https://github.com/NousResearch/hermes-agent.git
cd /tmp/hermes-agent && uv pip install -e . --python /opt/hermes-dev/bin/python

# 5. Link as default
mv /usr/local/bin/hermes /usr/local/bin/hermes-old
ln -s /opt/hermes-dev/bin/hermes /usr/local/bin/hermes

# 6. Install extra packages (e.g. scrapling)
uv pip install "scrapling[fetchers]" --python /opt/hermes-dev/bin/python
```

## Scrapling Browser Note
Playwright doesn't support Ubuntu 26.04. System Chromium at `/usr/bin/chromium-browser`.
Scrapling HTTP mode works without browser; stealth/dynamic modes need Playwright install.

## Skills Installed This Session
- `research/scrapling` — web scraping, Cloudflare bypass, JS rendering
- `research/searxng-search` — meta-search (needs self-hosted SearXNG)
- `research/osint-investigation` — public records OSINT
- `web-development/page-agent` — in-page AI copilot (web dev only)