hermes-travel
Status: experimental. Actor output shapes are scraped, undocumented, and can change without notice — this plugin was shipped once already with several tools silently returning empty results because of field-name mismatches (see Known limitations). Verify results before relying on them for a real booking decision.
A Hermes trip planner for travelers. Search hotels, homes, and hostels with the same stay dates, compare lodging, and plan a transport leg — then talk about the options as cards (name, price, score, times).
Tools
Lodging (same args: destination, checkin, checkout, guests, rooms, currency, max_price):
search_booking— Find hotels with live ratessearch_airbnb— Find short-term homessearch_agoda— Find hotels (Asia-heavy inventory)search_hostelworld— Find hostels and dorms
Transport:
search_flixbus— Coach buses (Europe-focused)search_rome2rio— Door-to-door routessearch_flights— Flights, worldwidechangi_timetable— Singapore Changi arrivals/departures
Orchestrators:
compare_stays— Merge lodging sources (lodging=hotels|homes|hostels|all)plan_leg— Merge routes for one origin → destination on a date
Results are stay or transport cards (default cap 8).
Install
Requires APIFY_API_TOKEN (console.apify.com/account/integrations) — every search runs an Apify Actor billed to your account. All wrapped Actors are on the free tier, but search_booking requests per-property detail (includeDetails) to get a usable name back, which costs one extra request per property.
From PyPI:
pip install hermes-travel
Directory install (for a Hermes install that loads plugins from a local dir):
mkdir -p ~/.hermes/plugins
cp -R /path/to/hermes-travel ~/.hermes/plugins/hermes-travel
hermes plugins enable hermes-travel
hermes plugins install prompts for the token when missing.
From a local checkout:
pip install /path/to/hermes-travel
Skill
Load skill_view("hermes-travel:travel-trip") for trip-planning guidance.
Skills: travel-trip (master SOP), travel-intake, itinerary-architecture, day-by-day, quote-and-docs. These cover the design phase of a trip (intake → architecture → day-by-day → quote) — not lead qualification/sales, and not post-booking follow-up. No CRM, no payments, no real bookings: this plugin only researches and quotes.
Known limitations
- Underlying Actors are reverse-engineered from mobile/private APIs, not public documented ones. Field names have shifted before without warning and can shift again — a tool that "returns empty" may mean the shape changed, not that there's no availability.
search_flixbushas no currency field in its output at all; the card'scurrencyfalls back to whatever was requested, which may not match reality if the Actor silently returns a different one.changi_timetablereports only one endpoint (the counterpart airport) per row — the other end is inferred from the search direction, not returned by the Actor.- No worldwide bus/rail coverage outside
search_flixbus(Europe) andsearch_rome2rio(door-to-door estimates); an earlier India/SE Asia bus tool was dropped for being too region-locked to be worth maintaining.
Metadata
Release files for hermes-travel 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hermes_travel-0.3.0.tar.gz | 19.9 kB | Without provenance | Details for hermes_travel-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hermes_travel-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for hermes_travel-0.3.0-py3-none-any.whl |
Total release size: 37.8 kB
Release files / hermes_travel-0.3.0.tar.gz
| Download URL | hermes_travel-0.3.0.tar.gz |
|---|---|
| Size | 19.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1c9d25d0978493fde9fd31d4fb490559034526810af1965579291bae1eb1f7b0
|
|
BLAKE2b-256 checksum How to use checksums |
13907c650096f476d9a2a9f3d8b47950808fd6782f142c7992e3bfb2623dea5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.0
|
Release files / hermes_travel-0.3.0-py3-none-any.whl
| Download URL | hermes_travel-0.3.0-py3-none-any.whl |
|---|---|
| Size | 17.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
44aff35f6b46586539ccad1874725e2181563c30e81dba275e1d49955f7fb05b
|
|
BLAKE2b-256 checksum How to use checksums |
f71d3c8b69e1a80b57165df254fbc9cd2dcfeb893cf2dd9f7ca822c38df26b29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.0
|
Security for hermes-travel 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.