shawn/matrix-hermes
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial project setup: Matrix auth, client, CLI #1

New Issue
Closed
opened 2026-05-23 15:39:03 +00:00 by shawn · 0 comments
shawn commented 2026-05-23 15:39:03 +00:00
Owner
Copy Link
Copy Source

Summary

Created matrix-hermes project with:

  • auth.py — Password login, token validation (whoami), logout against any Matrix homeserver
  • client.py — Async mautrix wrapper with messaging, room management, event listening
  • config.py — MatrixConfig dataclass with env/file loading (Hermes gateway compatible)
  • cli.py — CLI: login, whoami, logout, check, show-config
  • 52 tests across auth, config, and CLI

Environment Variables

Variable Description
MATRIX_HOMESERVER Homeserver URL
MATRIX_ACCESS_TOKEN Access token (preferred)
MATRIX_USER_ID Full user ID
MATRIX_PASSWORD Password (alternative)
MATRIX_ENCRYPTION Enable E2EE
MATRIX_DEVICE_ID Stable device ID

Usage

pip install -e .
matrix-hermes check
matrix-hermes login -H https://matrix.org -u @bot:matrix.org -p password
## Summary Created matrix-hermes project with: - **auth.py** — Password login, token validation (whoami), logout against any Matrix homeserver - **client.py** — Async mautrix wrapper with messaging, room management, event listening - **config.py** — MatrixConfig dataclass with env/file loading (Hermes gateway compatible) - **cli.py** — CLI: login, whoami, logout, check, show-config - **52 tests** across auth, config, and CLI ## Environment Variables | Variable | Description | |----------|-------------| | MATRIX_HOMESERVER | Homeserver URL | | MATRIX_ACCESS_TOKEN | Access token (preferred) | | MATRIX_USER_ID | Full user ID | | MATRIX_PASSWORD | Password (alternative) | | MATRIX_ENCRYPTION | Enable E2EE | | MATRIX_DEVICE_ID | Stable device ID | ## Usage ```bash pip install -e . matrix-hermes check matrix-hermes login -H https://matrix.org -u @bot:matrix.org -p password ```
shawn closed this issue 2026-05-23 15:39:03 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
shawn
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: shawn/matrix-hermes#1
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?