hermes - 💡(How to fix) Fix [Bug]: NixOS: WARNING gateway.run: Telegram: python-telegram-bot not installed after update to v0.14.0 [2 pull requests]

Bug Description

I am currently running Hermes via Nix (nix profile), rather than as a NixOS module. Upon upgrading to v0.14.0, I encountered the following error:

WARNING gateway.run: Telegram: python-telegram-bot not installed

Steps to Reproduce

1. Update hermes to v0.14 from nix.
2. hermes gateaway
3. get the error

Expected Behavior

Should be able to find load telegram extension.

Actual Behavior

Cannot find python-telegram-bot dependency.

Affected Component

Gateway (Telegram/Discord/Slack/WhatsApp), Setup / Installation

Messaging Platform (if gateway-related)

Telegram

Debug Report

gateway log:


2026-05-16 14:29:59,054 WARNING gateway.run: Telegram: python-telegram-bot not installed
2026-05-16 14:29:59,055 WARNING gateway.run: No adapter available for telegram
2026-05-16 14:29:59,055 WARNING gateway.run: No adapter could be created for any of the 1 configured platform(s). Check that required dependencies are installed and credentials are set. Gateway will continue for cron job execution.

Operating System

nixOS

Python Version

No response

Hermes Version

g0.14.0

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

The likely root cause is the May 12 dependency policy change in pyproject.toml. Telegram has been moved to the optional messaging extra:

• pyproject.toml:84: messaging = ["python-telegram-bot[webhooks]==22.6", ...]
• pyproject.toml:179: messaging (Telegram/Discord/Slack) was removed from the [all] group.

However, the Nix package continues to build only the [all] group by default:

• nix/hermes-agent.nix:36: dependency-groups = [ "all" ] ++ extraDependencyGroups

Consequently, the Nix-built Hermes no longer includes python-telegram-bot. I verified the cached installation: while Hermes attempts to lazy-install Telegram at runtime via tools.lazy_deps.ensure("platform.telegram"), this relies on a uv pip install into the active virtual environment. Because this environment resides in the read-only /nix/store, the installation fails. The gateway subsequently catches the failure and logs the generic warning.

Proposed Fix (optional)

To resolve this, I recommend setting extraDependencyGroups = [ "messaging" ] by default for both the NixOS and nix run and nix profile module. This adjustment will ensure a seamless, uninterrupted experience for users installing hermes-agent via nix profile or nix run.

Are you willing to submit a PR for this?

• [x ] I'd like to fix this myself and submit a PR