Andoriña

What Andoriña does

Andoriña lets Hermes send text to any contact or group by name or number, upload documents, images, audio or video from local folders, and send voice notes using native push-to-talk support that shows a Recording status. Users can also schedule messages and search contacts, and the repository topics include google-contacts. A knowledge feature takes PDF or TXT uploads and injects their context into the model.

The README describes a security layer built from input_guard.py and tool_guard.py, a role-based access engine with Owner, Manager, Chatbot and Blocked roles plus allowed-folder validation, and a data loss prevention pipeline. Recent release notes mention semantic alerts with fuzzy, accent-insensitive keyword matching, a webhook with public URL detection, a webhook stability banner in the dashboard, and an updater that patches SOUL.md. A Python plugin sandbox is marked as coming soon. The documentation is bilingual in English and Spanish, and the project is developed exclusively for Linux.

Key features

• Send text to contacts or groups by name or number
• Send documents, images, audio or video from local folders
• Voice notes with native push-to-talk conversion
• Role-based access with Owner, Manager, Chatbot and Blocked roles
• Knowledge (RAG) from uploaded PDF or TXT files
• Zero-trust input and tool guards plus a data loss prevention pipeline

When to use it

• Having Hermes send scheduled WhatsApp messages
• Sending a file from your PC to a contact through the agent
• Restricting what different WhatsApp users can ask the agent to do

Who it is for: Linux users who want Hermes Agent to manage their WhatsApp messaging.

How it fits with Hermes Agent

Built for Hermes Agent as a WhatsApp add-on, tagged hermes-agent and skills on GitHub.

Requirements: Linux (the README says it is developed exclusively for Linux)

Note: The README labels the current release v1.5.2-Beta5, the project is Linux-only, and GitHub could not identify a license for the repository.

FAQ