Skip to content

Latest commit

Β 

History

158 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

HidaChat

English Italiano

Portable Windows Desktop Client (.NET 9 / WPF) featuring Multi-Account & Multi-Platform tab management (WhatsApp Web, Telegram Web, OpenClaw, and Hermes Agent), Instant Background Preloading, Built-In Message Translation, Native Toast Notifications & Popups, and Zero Installation.

License: Apache-2.0 .NET 9.0 Download Stable Download Latest Beta Total Downloads Last Commit Build Status Platforms AI Agents Tailscale Mesh


πŸ“Έ Live Demo & Preview

HidaChat Live Demo

Multi-Account Interface (Dark Mode) Instant Message Translation
Multi-Account Interface Message Translation
Native Windows Toast Notifications Dark & Light Themes
Windows Toast Notifications Dark and Light Themes

πŸ“¦ Quick Download & Installation for Windows

Option 1: Install via Windows Package Manager (winget)

winget install hidaba.HidaChat

Option 2: Portable ZIP (No Installation)

Choose between the Stable Release (tested, recommended for daily use) and the Latest Beta (preview of the newest features, bug fixes, and improvements):

Channel Version Status Download Link
🟒 Stable Release GitHub release (latest by date) Recommended ⬇️ Download Stable ZIP
🟠 Latest Beta GitHub release (latest by date including pre-releases) Preview ⬇️ Download Latest Beta ZIP
  • πŸ“‚ Quick start: Extract the ZIP file anywhere (Local Drive or USB Flash Drive) and launch HidaChat.exe.
  • πŸ”„ Automatic updates (OTA): HidaChat includes a built-in auto-updater. You can enable or disable the Beta channel at any time in Settings (Ctrl+,).

⚠️ Important Portability Note: Do not run HidaChat simultaneously from multiple computers accessing the same shared network folder. HidaChat is designed to be used by one PC at a time to prevent WebView2 profile lock conflicts.


🌟 Why HidaChat? (Comparison)

Feature HidaChat Official WhatsApp Desktop Official Telegram Desktop Altus (amanharwara/altus)
Installation Required ❌ No (100% Portable) βœ… Yes βœ… Yes βœ… Yes
Moveable Data / Portable βœ… Yes (ZIP / USB) ❌ No ❌ No ❌ No
Multi-Platform in One App βœ… Yes (4 Platforms) ❌ WhatsApp only ❌ Telegram only ❌ WhatsApp only
AI Agent Gateway (OpenClaw & Hermes) βœ… Yes (via Tailscale Mesh & Local) ❌ No ❌ No ❌ No
Multi-Account Tabs βœ… Yes (Isolated Profiles) ❌ No ⚠️ Switcher only βœ… Yes
Bulk Sender (Excel & CSV) βœ… Yes (WhatsApp & Telegram) ❌ No ❌ No ❌ No
Instant Tab Preloading βœ… Yes (Zero Reload Lag) ❌ No ❌ No ❌ No
Integrated Translation βœ… Yes (Hover + Page) ❌ No ⚠️ Basic ❌ No
Native Windows Toast & Popup βœ… Yes βœ… Yes βœ… Yes βœ… Yes
Engine Footprint WebView2 (Native Win) Electron Native C++ / Qt Electron
Open Source βœ… Yes (Apache-2.0) ❌ No ⚠️ GPL βœ… Yes

πŸš€ Key Features

πŸ“Š Multi-Platform Bulk Sender (Excel & CSV Automation)

  • Import from Excel & CSV: Directly load contact lists from .xlsx, .xls, or .csv files with intelligent automatic column mapping (Phone, Name, Surname, Company, Custom Text, Username).
  • WhatsApp & Telegram Support: Automate customized sequential message sending on both WhatsApp Web and Telegram Web (@username or phone number resolution).
  • Dynamic Placeholders & Templates: Compose messages using dynamic tags ({Nome}, {Cognome}, {Azienda}, {Telefono}, {Username}, {Testo}) with single-click insertion and real-time live preview.
  • Detailed Message Inspector: Inspect multiline formatted texts, emojis, and links before sending with 1:1 fidelity.
  • Anti-Spam Delay Protection: Configurable natural jitter delay with a strict 30-second minimum security threshold and live countdown timer to safeguard accounts from spam flags.
  • Full Execution Controls: Pause, Resume, Stop immediately, and monitor per-contact statuses (Pending, Sending..., Sent βœ”, Error βœ–, Invalid).

πŸ‘₯ Multi-Account & Multi-Platform (WhatsApp, Telegram, OpenClaw, Hermes)

  • 4 Supported Ecosystems: Manage simultaneous accounts across instant messaging and autonomous AI agents in distinct horizontal tabs:
    • 🟒 WhatsApp Web: Full web client with QR code login, real-time messaging, audio/video preview, instant message translation, and bulk sender integration.
    • πŸ”· Telegram Web: Full support for Telegram Web A, K, and Z with accurate Badging API integration (navigator.setAppBadge), zero phantom unread counts, and real-time alerts.
    • 🟠 OpenClaw (Autonomous AI Agent Gateway & Web UI): Native support for OpenClaw web UI. Connects seamlessly to local gateways (http://127.0.0.1:18789) or remote private tailnets via the built-in Tailscale mesh VPN daemon (tsnetd.exe). Uses deterministic local proxy ports (18800+) and persistent identity tokens so IndexedDB Ed25519 device keys remain permanent, eliminating repeated openclaw devices approve confirmations.
    • 🌐 Hermes Agent (Nous Research): Native dashboard and web console for Hermes AI agent instances. Features automatic Authorization: Bearer <token> injection in WebView2, local connectivity (http://127.0.0.1:9119), remote Tailscale mesh tunneling (18900+), and dedicated Hermes cyan branding (#00B0FF).
  • Isolated WebView2 Profiles: Each tab maintains its own independent cache, cookies, local storage, and login session under data/webview/.
  • Instant Preloading: Accounts are preloaded in the background on startup (prioritizing the active account), allowing zero-delay, instant switching between tabs without page reloads or black screen glitches.
  • Quick Platform Selector: Click the + button in the tab bar or in Settings to instantly add a WhatsApp, Telegram, OpenClaw, or Hermes tab with dedicated brand icons.
  • Background Notifications: Even when switching tabs or using AI agent consoles, messaging tabs keep receiving real-time WebSocket messages and trigger native Windows toasts and overlay popups.

🌐 Integrated Translation Engine

  • Hover Button: Hover over any incoming or outgoing message to display an instant translation button.
  • Full-Page Translation: Translate entire chat threads with a single click.
  • Multi-Platform Support: Fully compatible with both WhatsApp Web and Telegram Web K message DOM layouts.

🎨 Themes & Custom Window Management

  • Automatic Dark/Light Mode: Seamless synchronization with Windows system theme or manual override (with custom CSS and dark mode injection for both WhatsApp and Telegram).
  • Taskbar-Aware Maximize: Custom borderless window respecting the Windows taskbar across all monitors, with fluid drag-to-restore and interactive corner resize.

πŸ”” Notifications & System Tray

  • Windows Toast & Overlay Popups: Interactive toast and corner popups routing clicks straight to the originating account tab.
  • System Tray: Minimize to notification tray with unread message badge count.
  • Secure OTA Updates: Background check and direct updates via GitHub Releases with cryptographic SHA-256 integrity verification.

πŸ’» System Requirements

  • OS: Windows 10 (version 20H1 / build 19041 or higher) or Windows 11
  • Runtime: Microsoft Edge WebView2 Runtime (pre-installed on Windows 11)
  • Framework: .NET 9.0 Runtime

πŸ› οΈ Building from Source

To compile and run the project locally:

# Clone repository
git clone https://github.com/hidaba/HidaChat.git
cd HidaChat

# Restore dependencies and build
dotnet restore
dotnet build -c Release

Alternatively, open HidaChat.sln in Visual Studio 2022 (.NET 9 SDK installed) and press F5.


πŸ“– Quick Start Guide

  1. Add Accounts: Launch HidaChat.exe. Click the + button on the top tab bar to choose from WhatsApp, Telegram, OpenClaw, or Hermes Agent.
  2. Log In & Connect:
    • WhatsApp: Scan the displayed QR code using your WhatsApp mobile app (Linked Devices).
    • Telegram: Scan the QR code with your Telegram mobile app or log in via phone number / SMS code.
    • OpenClaw: Enter your Gateway URL (default http://127.0.0.1:18789 or remote Tailnet IP/hostname) and Auth Token. Enable Tailscale Mesh Integration if connecting over a private Tailnet without installing Tailscale on Windows. Click Test Connection to verify status.
    • Hermes Agent: Enter the Hermes URL (default http://127.0.0.1:9119 or remote Tailnet address) and Auth Token / API Key (automatically injected as Bearer token). Enable Tailscale Mesh Integration if needed, and click Test Connection.
  3. Rename & Organize Tabs: Right-click on any tab header and select Rename to customize the label, or configure accounts anytime via Settings (βš™οΈ).
  4. Translate Messages: Hover over any chat bubble in WhatsApp or Telegram to display the instant translation button 🌐.

πŸ•ΉοΈ Title Bar Controls

Icon Function
πŸ“Š Open Excel / CSV Bulk Sender (Automated personalized messaging)
βš™οΈ Open Settings (Theme, Language, Account Management, Beta channel)
πŸ”„ Reload active account webview
β“˜ About HidaChat (Version, license, portable path)
βœ• / β€” Minimize to system tray or taskbar

πŸ€– Connecting OpenClaw & Hermes Agent Accounts (Step-by-Step Guide)

HidaChat supports autonomous AI agent gateways and web consoles alongside standard instant messengers. Each AI tab runs in an isolated WebView2 environment with persistent storage, zero reload lag, and instant background preloading.

🟠 1. OpenClaw (Autonomous AI Agent Gateway & Web UI)

OpenClaw connects HidaChat to your local or private-cloud autonomous agent instances.

  1. Add the Account: Click the + button in the top tab bar and select OpenClaw (or navigate to Settings (βš™οΈ) βž” Accounts βž” Add account and choose OpenClaw from the platform dropdown).
  2. Server / Gateway URL:
    • Local instance: Default is http://127.0.0.1:18789.
    • Remote or Tailnet instance: Enter your private Tailscale IP or node hostname (e.g., http://100.x.y.z:18789 or http://my-openclaw-node:18789).
  3. Gateway Auth Token:
    • Enter your OpenClaw gateway authentication token (configured in your openclaw.json or passed via command line --token).
  4. Tailscale Mesh Integration (Built-in tsnet):
    • Local / LAN Connection: Leave "Usa nodo Tailscale integrato" / "Use built-in Tailscale node" unchecked. HidaChat connects directly via standard HTTP loopback.
    • Private Tailscale Mesh: If your OpenClaw gateway resides on a remote private Tailnet and you do not have (or want) Tailscale installed on your Windows PC, check "Usa nodo Tailscale integrato (tsnet portatile)".
    • Deterministic Proxy & Device Identity: HidaChat runs an internal companion daemon (tsnetd.exe) using deterministic loopback proxy ports (18800+). This ensures that your IndexedDB Ed25519 cryptographic device key pair remains permanently bound to the profile, completely eliminating repetitive device approval prompts (openclaw devices approve).
  5. Verify & Test:
    • Click Test Connessione (Test Connection). A green status confirming connectivity and token validity will be displayed.
    • Switch to the OpenClaw tab in the main window to start interacting with your autonomous agent.

🌐 2. Hermes Agent (Nous Research)

Hermes Agent provides a responsive Web Console and Dashboard for Nous Research Hermes AI models and autonomous agent workflows.

  1. Add the Account: Click + in the tab bar and select Hermes Agent (or in Settings (βš™οΈ) βž” Accounts, choose Hermes Agent).
  2. Server URL:
    • Local instance: Default is http://127.0.0.1:9119.
    • Remote server: Enter the remote Tailnet or LAN host address (e.g., http://100.x.y.z:9119).
  3. Auth Token / API Key:
    • Enter your Hermes API Key or access token.
    • Automatic Bearer Token Injection: HidaChat's WebView2 handler automatically injects the Authorization: Bearer <token> header into outbound HTTP requests for the target host, providing seamless single-sign-on directly into the web console.
  4. Tailscale Mesh Mode:
    • For remote private nodes on Tailscale, check "Usa nodo Tailscale integrato" (operates via dedicated deterministic loopback proxy 18900+).
  5. Test Connection:
    • Click Test Connessione to confirm reachability, then switch to the Hermes tab to start chatting with your agent.

πŸ—ΊοΈ Roadmap & Changelog

Check out CHANGELOG.md to see release history and recent updates.


🀝 Contributing & Security


πŸ“„ License

Distributed under the Apache 2.0 License. See LICENSE.txt for details.


🏷️ Search Tags & Keywords

openclaw Β· openclaw-gateway Β· hermes Β· hermes-agent Β· nous-research Β· ai-agents Β· ai-gateway Β· tailscale Β· tsnet Β· mesh-vpn Β· whatsapp-web Β· telegram-web Β· multi-account Β· portable-app Β· dotnet9 Β· wpf Β· webview2 Β· desktop-client Β· bulk-sender Β· translation Β· windows-desktop

About

Client desktop multi-account portabile (.NET 9 / WPF) per WhatsApp, Telegram, OpenClaw e Hermes con traduzione e notifiche native.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages