VKEncrypt

Private VK chats for humans and Hermes agents. AES-256-GCM, one shared seed, automatic reply encryption, emoji/Cyrillic transports, and long-message assembly. The key stays local; VK sees only ciphertext.

Install in Tampermonkey · Install Hermes adapter · GitHub

30 seconds

Browser

1. Install Tampermonkey.
2. Open Install VKEncrypt.
3. Open a VK chat and create one seed phrase. Enter the same seed on every device.

Hermes

This is the VKCipher adapter, not the upstream web3blind/hermes-vk-platform. It lives in integrations/hermes-vk-platform and installs to ~/.hermes/plugins/vk.

Install from any Bash shell:

bash <(curl -fsSL https://github.com/megamen32/VKCipher/raw/refs/heads/main/scripts/install-hermes-vk-plugin.sh)

Configure the VK community once. Then open Hermes Channels -> VK Messenger:

• enter the same seed in the masked VKEncrypt seed field;
• leave Answer unencrypted messages disabled for fail-closed operation;
• save the platform settings and restart the gateway when Hermes prompts you.

The CLI remains useful for headless installs or recovery:

hermes gateway setup
bash <(curl -fsSL https://github.com/megamen32/VKCipher/raw/refs/heads/main/scripts/hermes-vk-key.sh) set-seed --restart

The seed prompt is hidden. To rotate to a direct 64-hex key:

bash <(curl -fsSL https://github.com/megamen32/VKCipher/raw/refs/heads/main/scripts/hermes-vk-key.sh) set-key --restart

Key rotation is immediate after the restart, but old messages require the old seed/key. Never paste a seed into a public chat or commit it to Git.

What works

• VK vk.com, vk.ru, and web.vk.me userscript.
• Hermes VK community bot with encrypted inbound and outbound text.
• Emoji, Base64, and experimental Russian-word transports.
• Long encrypted messages split and reassembled automatically.
• Per-chat key selection in the browser; per-peer encrypted sessions in Hermes.
• Voice and encrypted file flows in the browser adapter.

Security model

The browser and Hermes derive compatible AES-256-GCM keys from the same seed using PBKDF2-SHA256. Hermes fails closed for plaintext when an encrypted peer session is required. This project is not independently audited; protect the seed like a password and verify the code before using it for sensitive traffic.

Links

• Hermes adapter README
• Hermes key manager
• Browser extension details
• Russian dictionary and format
• Technical crypto notes
• Bot middleware
• Chrome/Firefox/Safari builds

Development

npm install
npm run build
npm test:middleware
node --test tests/hermes-installers.test.mjs

License

MIT