Hermes
Getting started

Installation

Install the Hermes agent, pull the skills, and connect your data.

Requirements

  • The Hermes agent (Linux, macOS, or WSL2; the installer bundles what it needs)
  • Access to a model provider configured in your Hermes profile
  • Credentials for the GIS sources you want to query (an ArcGIS token, a PostGIS connection string, and so on)

1. Install Hermes

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc

Choose a provider with hermes model, or run hermes setup --portal to log in and enable the Tool Gateway.

2. Pull the GIS skills

The skills live in a GitHub repo. Clone it into your Hermes skills directory:

git clone github.com/daraobeirnecode/hermes-gis-skills ~/.hermes/skills/gis

Repo status

The skills repo is not published yet. Once it is, this one command loads all 21 GIS skills into your profile. Until then, the skills live in the Mercator profile they were authored in.

3. Connect your data

Set credentials as environment variables; the tools read them at call time.

~/.hermes/.env
ARCGIS_TOKEN=...
POSTGIS_URL=postgresql://user:pass@host:5432/gis_lab

4. Enable the toolset and ask something

hermes tools   # toggle esri, open-data, postgis
hermes
 which zoning district covers 1234 J Street?

Next: Your first spatial query.

On this page