https://github.com/dcrypt3d/hermes-conversation
https://github.com/dcrypt3d/hermes-conversation
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dcrypt3d/hermes-conversation
- Owner: dcrypt3d
- Created: 2026-04-23T00:48:02.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-23T01:15:40.000Z (2 months ago)
- Last Synced: 2026-04-23T01:29:34.560Z (2 months ago)
- Language: Python
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hermes Conversation
Home Assistant conversation agent powered by Hermes Agent.
## Setup
### 1. Hermes MCP Server
The integration requires the Hermes MCP server running on your Mac:
```bash
pip install hermes-agent
hermes mcp-server &
```
This starts the server on port **9583**.
To allow Home Assistant (on another machine) to connect, use your Mac's LAN IP:
```bash
ipconfig getifaddr en0
```
Set the URL in the integration config to `http://:9583`.
### 2. Install in Home Assistant
**Option A — HACS (recommended):**
1. Add this repository as a custom repository in HACS
2. Search for "Hermes Conversation" and install
3. Restart Home Assistant
4. Go to **Settings → Devices & Services → Add Integration** and search for "Hermes Conversation"
5. Enter your Hermes MCP server URL (e.g. `http://192.168.X.X:9583`)
**Option B — Manual:**
1. Copy `custom_components/hermes_conversation` to your HA config's `custom_components/` folder
2. Restart Home Assistant
3. Add the integration via Settings → Devices & Services
### 3. Usage
After setup, use the Home Assistant conversation panel to chat with Hermes. Conversation history is maintained within each session.