All plugins

polyglot

Live interpreter for group chats on the Hermes gateway (Telegram, Discord): an authorized user sends /polyglot on in a group, and every message from a sender Hermes admits is then translated into each other member's reading language, returned as the reply. Languages are learned from each person's first message or set with /lang; "hermes, ..." or an @mention still reaches Hermes as a normal question. Translates with the user's own Hermes model; a Sarvam AI key is optional for Indian languages. Disclosure — registers one hook (post_gateway_admission, so it runs only after Hermes's authorization) and two commands (/polyglot, /lang), no tools; in chats where an authorized user ran /polyglot on, message text from admitted members goes to the configured model provider through Hermes's ctx.llm, and, only if SARVAM_API_KEY is set, text for Indian languages goes to https://api.sarvam.ai; translations are posted back to the group as the bot's reply, and ordinary group messages in those chats no longer start an agent turn; stores each group's member languages and display names in Hermes's plugin state; no file reads, shell commands, background processes or telemetry.

Subramanyarao11Platformv0.2.0Updated 7 days ago

About

Live interpreter for group chats on the Hermes gateway (Telegram, Discord): an authorized user sends /polyglot on in a group, and every message from a sender Hermes admits is then translated into each other member's reading language, returned as the reply. Languages are learned from each person's first message or set with /lang; "hermes, ..." or an @mention still reaches Hermes as a normal question. Translates with the user's own Hermes model; a Sarvam AI key is optional for Indian languages. Disclosure — registers one hook (post_gateway_admission, so it runs only after Hermes's authorization) and two commands (/polyglot, /lang), no tools; in chats where an authorized user ran /polyglot on, message text from admitted members goes to the configured model provider through Hermes's ctx.llm, and, only if SARVAM_API_KEY is set, text for Indian languages goes to https://api.sarvam.ai; translations are posted back to the group as the bot's reply, and ordinary group messages in those chats no longer start an agent turn; stores each group's member languages and display names in Hermes's plugin state; no file reads, shell commands, background processes or telemetry.

Polyglot: a live interpreter for Hermes group chats

Grandma writes in Kannada. Her grandson in Toronto reads English. The cousin in Madrid reads Spanish.
With Polyglot, they're all in one group with Hermes, and each of them reads every message in their own
language.

Asha:   ನಾಳೆ ಹಬ್ಬಕ್ಕೆ ಎಲ್ಲರೂ ಬರ್ತೀರಾ?
Hermes: 🌐 English: Is everyone coming for the festival tomorrow?
        🌐 Español: ¿Vienen todos a la fiesta mañana?

Ravi:   Yes! Landing at 6pm 🎉
Hermes: 🌐 ಕನ್ನಡ: ಹೌದು! ಸಂಜೆ 6 ಗಂಟೆಗೆ ಇಳಿಯುತ್ತೇನೆ 🎉
        🌐 Español: ¡Sí! Aterrizo a las 6 de la tarde 🎉

Setup (two minutes)

  1. Install: hermes plugins install polyglot, then restart the gateway (hermes gateway restart).
  2. Add your Hermes bot to a group. On Telegram, turn the bot's privacy mode off in @BotFather
    (/setprivacy → Disable) so it can read group messages.
  3. In the group, an authorized Hermes user sends /polyglot on.
  4. Decide who is translated. Polyglot only sees messages from people Hermes admits: it runs after
    Hermes's own authorization, so other members' messages are neither translated nor sent to your
    model. To include someone, add their user ID to Hermes's allowlist, for example
    TELEGRAM_GROUP_ALLOWED_USERS=<id>,<id> (group-only access) or TELEGRAM_ALLOWED_USERS in Hermes's
    .env, then restart the gateway. Admitted members can also talk to Hermes in the group, so only add
    people you trust. See the Telegram
    (or your platform's) messaging guide for all the allowlist settings. If you set
    telegram.require_mention: true, list the group in telegram.free_response_chats so ordinary
    messages reach Polyglot.
  5. Everyone just chats. Polyglot learns each person's language from the first message they write
    and tells them what it picked. To read in a different language, send /lang <language>:
    /lang english, /lang kannada, /lang हिन्दी, /lang español… Native names, English names and
    codes all work, and any language your model knows is accepted.

That's it. It uses the model Hermes already runs on, so there is nothing else to configure.

Optional: Sarvam AI for Indian languages. Add a Sarvam AI key in
Desktop → Settings → Plugins → Polyglot (or SARVAM_API_KEY in Hermes's secrets). Polyglot then uses
Sarvam for translation between Indian languages and English (all 22 scheduled languages), including
code-mixed text like Hinglish and Kanglish. Everything else still goes to your model.

Optional: a cheaper model for translation. Polyglot registers its own model slot, Polyglot
translation
. Pick a fast model for it in hermes model → auxiliary models (or Desktop → Settings →
Models → Auxiliary). By default it uses your main model.

Commands

CommandWhoWhat
/polyglot on / offAuthorized Hermes usersStart or stop interpreting this group
/polyglot statusAuthorized Hermes usersWhich engine is used, and who reads what
/lang <language>Any admitted member, in a group where Polyglot is onChange the language you read the group in (it is picked automatically from your first message)
/lang offAny admitted memberStop receiving translations
/langAny admitted memberShow everyone's languages

Talking to Hermes still works: start a message with "hermes," (configurable) or @mention the bot,
and Hermes answers as usual instead of translating.

How it works

Polyglot uses Hermes's post_gateway_admission hook, which runs once for each message Hermes has
admitted (after authorization and slash commands), before the agent. In a group where Polyglot is on, it:

  1. leaves commands and messages addressed to Hermes to the normal agent turn, and silently consumes
    messages with nothing to translate (emoji, links, "+1");
  2. works out which languages the group reads, excluding the language the message is actually written in
    (a member's chosen language is only a hint: people switch languages mid-chat);
  3. translates into all of them in one model call (or with Sarvam for Indian language pairs), with
    instructions to keep names, emoji, tone and code-mixing, and never to act on the message's content;
  4. returns the translation as the reply, one line per language, and does not start an agent turn.

Voice notes are not translated in this version: the admission hook receives message text only, and
Hermes transcribes voice notes later, inside the agent turn. In a group where Polyglot is on, a voice
note without a caption is passed over quietly (neither translated nor answered); address Hermes in text
("hermes, ...") to ask it something.

Privacy, cost and what this plugin does (disclosure)

  • Network calls: message text goes to the model provider Hermes is configured with (through Hermes's
    own ctx.llm). If you add a Sarvam key, message text for Indian languages also goes to
    https://api.sarvam.ai. No other services are contacted. No telemetry.
  • Which chats and people: Polyglot acts only in groups where an authorized Hermes user ran
    /polyglot on, and only on messages from senders Hermes admitted (it runs after Hermes's
    authorization, through post_gateway_admission). Messages from anyone else never reach it, so they
    cost nothing and are not stored. /lang only changes the sender's own reading language. Each translated message
    costs one model call (or Sarvam calls), so turn Polyglot off in groups that don't need it.
  • Data kept: per group, the members' chosen languages and display names, stored in Hermes's plugin
    state (<hermes home>/plugin-data/). Messages and translations are not stored by the plugin.
  • No shell commands, no background processes, no files outside the plugin's own state.

Develop

uv run --no-project --with pytest python -m pytest tests -q   # offline tests, fake gateway + model
hermes plugins validate .                                     # the check the catalog runs

MIT licensed.

README from the reviewed commit fbe2fc0; it updates when the author re-pins.

More by Subramanyarao11

3 plugins by Subramanyarao11 in the catalog.

Subramanyarao11sarvamSarvam AI for Hermes: speech-to-text (voice notes and live transcription in voice mode) and text-to-speech (Bulbul voices) for 22 Indian languages, plus six tools: sarvam_translate, sarvam_transliterate, sarvam_detect_language, sarvam_read_document (PDF/image OCR), sarvam_translate_document and sarvam_transcribe_recording (long audio with speaker labels). Not affiliated with Sarvam AI. Disclosure — registers one transcription provider, one TTS provider and six tools (toolset "sarvam"), no hooks; requests go to https://api.sarvam.ai (and wss://api.sarvam.ai for live transcription) with SARVAM_API_KEY read through Hermes's secret store; document translation and long recordings upload the file to, and download results from, the signed https storage URL Sarvam returns for that job; sends audio Hermes asks to transcribe, text to speak, tool text, and files whose path the agent supplies; writes the requested audio file and translated document copies beside the original under a new name; one WebSocket only while live transcription runs; no stored state, shell commands, background processes or telemetry; every call is billed by Sarvam to the user's key.CommunityvoiceSubramanyarao11sarvam-providerSarvam AI as a Hermes model provider (--provider sarvam): Sarvam-105B and the open models Sarvam hosts in India, with tool calls, JSON output and reasoning levels. Not affiliated with Sarvam AI. Disclosure — registers one model provider at import and nothing else (no tools, hooks, commands or threads); chat requests go to https://api.sarvam.ai through Hermes's own client with SARVAM_API_KEY, which Hermes reads; the plugin itself opens no connections, reads and writes no files and starts no processes.Communitymodels

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section