{"id":26157924,"url":"https://github.com/iongpt/llm-for-whatsapp","last_synced_at":"2025-04-05T21:06:05.951Z","repository":{"id":214073048,"uuid":"735591814","full_name":"iongpt/LLM-for-Whatsapp","owner":"iongpt","description":"WhatsApp auto responder with LLM integration. It support OpenAI API and also local LLMs","archived":false,"fork":false,"pushed_at":"2025-03-17T05:42:11.000Z","size":1601,"stargazers_count":129,"open_issues_count":3,"forks_count":15,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-05T21:05:57.128Z","etag":null,"topics":["autoanswer","huggingface","llamacpp","llm","ollama","openai","openai-chatgpt","whatsapp","whatsapp-bot"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iongpt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-25T13:21:19.000Z","updated_at":"2025-04-02T17:04:06.000Z","dependencies_parsed_at":"2025-03-10T19:32:48.804Z","dependency_job_id":null,"html_url":"https://github.com/iongpt/LLM-for-Whatsapp","commit_stats":null,"previous_names":["iongpt/llm-for-whatsapp"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iongpt%2FLLM-for-Whatsapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iongpt%2FLLM-for-Whatsapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iongpt%2FLLM-for-Whatsapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iongpt%2FLLM-for-Whatsapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iongpt","download_url":"https://codeload.github.com/iongpt/LLM-for-Whatsapp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399871,"owners_count":20932876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autoanswer","huggingface","llamacpp","llm","ollama","openai","openai-chatgpt","whatsapp","whatsapp-bot"],"created_at":"2025-03-11T10:29:13.011Z","updated_at":"2025-04-05T21:06:05.898Z","avatar_url":"https://github.com/iongpt.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WhatsApp LLM Assistant\n\nWhatsApp client with LLM-powered auto-replies for Mac, Windows, and Linux.\n\n## Get Started in Minutes\n\n**Just want to run the app?** Here's how:\n\n1. **[Download release.zip](https://github.com/iongpt/LLM-for-Whatsapp/releases/latest/download/release.zip)** - Get the latest version directly\n2. **Extract** the zip file anywhere on your computer\n3. **Run** the script for your system:\n   - **Windows**: Double-click `run-windows.bat` \n   - **Mac**: Open Terminal, navigate to folder, run `chmod +x run-mac.sh \u0026\u0026 ./run-mac.sh`\n   - **Linux**: Open Terminal, navigate to folder, run `chmod +x run-linux.sh \u0026\u0026 ./run-linux.sh`\n\nThat's it! The script will install everything needed and launch the app.\n\n## Key Features\n\n- **Interactive LLM Integration**: Choose between OpenAI's GPT, local models via Ollama, or other custom LLM APIs\n- **Selective Auto-Reply**: Enable or disable auto-reply for specific chats\n- **Customizable System Prompts**: Define how your AI assistant should behave in conversations\n- **Multi-Platform Support**: Works on Windows, macOS, and Linux\n- **Message History**: Maintains conversation context for more coherent responses\n\n## Installation - Quick Setup (Recommended)\n\n1. Download the latest `release.zip` file from the [Releases page](https://github.com/iongpt/LLM-for-Whatsapp/releases)\n2. Extract the contents of the ZIP file to any location on your computer\n3. Run the appropriate script for your operating system:\n   - **Windows**: Double-click `run-windows.bat`\n     - If Node.js is installed during setup, you'll need to close and run the script again\n   - **macOS**: \n     - Open Terminal\n     - Navigate to the extracted folder: `cd path/to/extracted/folder`\n     - Make the script executable: `chmod +x run-mac.sh`\n     - Run the script: `./run-mac.sh`\n   - **Linux**: \n     - Open Terminal\n     - Navigate to the extracted folder: `cd path/to/extracted/folder`\n     - Make the script executable: `chmod +x run-linux.sh`\n     - Run the script: `./run-linux.sh`\n\nFor detailed installation instructions, see the included `install_instructions.md` file.\n\n## Installation - Manual Setup (For Developers)\n\n### Prerequisites\n- Node.js\n- npm or yarn\n\n### Setup and Run\n\n1. Clone the repository\n```\ngit clone https://github.com/iongpt/LLM-for-Whatsapp.git\ncd LLM-for-Whatsapp\n```\n\n2. Install dependencies\n```\nnpm install\n```\nor if you prefer yarn:\n```\nyarn install\n```\n\n3. Build the application\n```\nnpm run build\n```\nor if you prefer yarn:\n```\nyarn build\n```\n\n4. Start the application\n```\nnpm run start\n```\nor if you prefer yarn:\n```\nyarn start\n```\n\n## WhatsApp Authentication\n\n1. Launch the application\n2. Scan the QR code with WhatsApp on your phone (Menu \u003e WhatsApp Web \u003e Link a Device)\n3. After authentication, your chats will appear in the left sidebar\n\n## Using Auto-Reply\n\n1. Select a chat from the sidebar\n2. Toggle the \"Auto-reply\" switch to enable AI responses for that chat\n3. The assistant will automatically respond to incoming messages in that chat\n4. You can also toggle \"Auto-reply to all chats\" in the Settings tab\n\n## Configuration Options\n\n### LLM Provider Settings\n- OpenAI API (requires API key)\n- Local models via Ollama\n- Custom API endpoints for other LLM providers\n\n### Response Settings\n- Temperature: Control randomness of responses (0.0-2.0)\n- System prompt: Define assistant behavior\n- History length: Number of messages to include for context\n\n## Building Packages\n\nTo build for your platform:\n\n```\n# For all platforms\nnpm run package:all\n\n# For Windows\nnpm run package:win\n\n# For macOS\nnpm run package:mac\n\n# For Linux\nnpm run package:linux\n```\n\n## Development\n\n```\n# Run in development mode with auto-reload\nnpm run dev\n\n# Run linting\nnpm run lint\n```\n\nYou can also use `yarn` instead of `npm run` for all the commands above if you prefer.\n\n## Customizing LLM Integration\n\nFor details on integrating custom LLM backends, check out our [custom_LLM.md](custom_LLM.md) guide.\n\n## Utility Scripts\n\nSeveral utility scripts are included to help with troubleshooting:\n\n- **apply-settings.js**: Applies all necessary settings for reply delay features\n- **fix-settings.js**: Fixes issues with default settings\n- **debug-settings.js**: Creates a debug window to inspect current settings\n- **troubleshoot/inspect-settings.js**: Inspects and modifies settings files\n\nTo run these scripts:\n```\nnode apply-settings.js\n```\n\n## Disclaimer\n\nThis project is not affiliated with WhatsApp or Meta. It uses an unofficial WhatsApp Web client library and should be used responsibly and in accordance with WhatsApp's terms of service.\n\n## License\n\nMIT License","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiongpt%2Fllm-for-whatsapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiongpt%2Fllm-for-whatsapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiongpt%2Fllm-for-whatsapp/lists"}