# WATBOT - WhatsApp & Instagram Automation Bot
## Quick Links
- 📚 **Documentation**: [README.md](README.md)
- 🚀 **Quick Start**: [QUICKSTART.md](QUICKSTART.md)
- 📦 **Deployment**: [DEPLOYMENT.md](DEPLOYMENT.md)
- 💡 **Examples**: [examples/](examples/)
## Installation & Usage
### Method 1: Interactive (Easiest)
```bash
python start.py
```
Follow the prompts!
### Method 2: Python Script
```python
from watbot import WhatsAppBot
bot = WhatsAppBot()
bot.start()
```
### Method 3: Command Line
```bash
watbot start
```
### Method 4: Custom Config
```python
from watbot import WhatsAppBot, BotConfig
config = BotConfig()
config.whatsapp.monitor_contacts = ["Mom", "Dad"]
config.ai.personality = "friendly and helpful"
bot = WhatsAppBot(config=config)
bot.start()
```
## Features
✅ **Implemented**
- WhatsApp automation with AI responses
- Context-aware conversations
- Multiple contact monitoring
- Debug mode
- Headless/headed browser support
- Custom AI personalities
- Session persistence
- Config file support
- CLI interface
- Python library API
🚧 **Coming Soon**
- Instagram automation
- Advanced analytics
- Web dashboard
- Multi-language support
- Scheduled messages
- Custom triggers
## Project Structure
```
watbot/ # Python package
├── __init__.py # Package init
├── config.py # Configuration
├── whatsapp_bot.py # WhatsApp wrapper
└── cli.py # Command-line interface
examples/ # Usage examples
├── whatsapp_examples.py # Python examples
└── config_example.json # Config template
smart_whatsapp_bot.js # Node.js automation
gemini_bot.py # AI responses
start.py # Interactive launcher
test_watbot.py # Test suite
```
## Development
```bash
# Clone repo
git clone https://github.com/nithin434/woat.git
cd woat
# Install dependencies
npm install
pip install -e .
# Run tests
python test_watbot.py
# Start bot
python start.py
```
## Support
- 🐛 Report bugs: [GitHub Issues](https://github.com/nithin434/woat/issues)
- 💬 Discussions: [GitHub Discussions](https://github.com/nithin434/woat/discussions)
- 📧 Email: nithin@example.com
- ⭐ Star the repo if you like it!
## License
MIT License - see [LICENSE](LICENSE)
---
Made with ❤️ by [Nithin Jambula](https://github.com/nithin434)
Raw data
{
"_id": null,
"home_page": "https://github.com/nithin434/woat",
"name": "watbot",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "whatsapp, instagram, bot, automation, ai, chat, messaging, api",
"author": "Nithin Jambula",
"author_email": "nithin@example.com",
"download_url": "https://files.pythonhosted.org/packages/d5/2d/806803b1a048242832096de3ff1e08077be5db1273f0e156c0a6f29e800d/watbot-0.1.1.tar.gz",
"platform": null,
"description": "# WATBOT - WhatsApp & Instagram Automation Bot\n\n## Quick Links\n\n- \ud83d\udcda **Documentation**: [README.md](README.md)\n- \ud83d\ude80 **Quick Start**: [QUICKSTART.md](QUICKSTART.md)\n- \ud83d\udce6 **Deployment**: [DEPLOYMENT.md](DEPLOYMENT.md)\n- \ud83d\udca1 **Examples**: [examples/](examples/)\n\n## Installation & Usage\n\n### Method 1: Interactive (Easiest)\n```bash\npython start.py\n```\nFollow the prompts!\n\n### Method 2: Python Script\n```python\nfrom watbot import WhatsAppBot\n\nbot = WhatsAppBot()\nbot.start()\n```\n\n### Method 3: Command Line\n```bash\nwatbot start\n```\n\n### Method 4: Custom Config\n```python\nfrom watbot import WhatsAppBot, BotConfig\n\nconfig = BotConfig()\nconfig.whatsapp.monitor_contacts = [\"Mom\", \"Dad\"]\nconfig.ai.personality = \"friendly and helpful\"\n\nbot = WhatsAppBot(config=config)\nbot.start()\n```\n\n## Features\n\n\u2705 **Implemented**\n- WhatsApp automation with AI responses\n- Context-aware conversations\n- Multiple contact monitoring\n- Debug mode\n- Headless/headed browser support\n- Custom AI personalities\n- Session persistence\n- Config file support\n- CLI interface\n- Python library API\n\n\ud83d\udea7 **Coming Soon**\n- Instagram automation\n- Advanced analytics\n- Web dashboard\n- Multi-language support\n- Scheduled messages\n- Custom triggers\n\n## Project Structure\n\n```\nwatbot/ # Python package\n\u251c\u2500\u2500 __init__.py # Package init\n\u251c\u2500\u2500 config.py # Configuration\n\u251c\u2500\u2500 whatsapp_bot.py # WhatsApp wrapper\n\u2514\u2500\u2500 cli.py # Command-line interface\n\nexamples/ # Usage examples\n\u251c\u2500\u2500 whatsapp_examples.py # Python examples\n\u2514\u2500\u2500 config_example.json # Config template\n\nsmart_whatsapp_bot.js # Node.js automation\ngemini_bot.py # AI responses\nstart.py # Interactive launcher\ntest_watbot.py # Test suite\n```\n\n## Development\n\n```bash\n# Clone repo\ngit clone https://github.com/nithin434/woat.git\ncd woat\n\n# Install dependencies\nnpm install\npip install -e .\n\n# Run tests\npython test_watbot.py\n\n# Start bot\npython start.py\n```\n\n## Support\n\n- \ud83d\udc1b Report bugs: [GitHub Issues](https://github.com/nithin434/woat/issues)\n- \ud83d\udcac Discussions: [GitHub Discussions](https://github.com/nithin434/woat/discussions)\n- \ud83d\udce7 Email: nithin@example.com\n- \u2b50 Star the repo if you like it!\n\n## License\n\nMIT License - see [LICENSE](LICENSE)\n\n---\n\nMade with \u2764\ufe0f by [Nithin Jambula](https://github.com/nithin434)\n",
"bugtrack_url": null,
"license": null,
"summary": "WhatsApp & Instagram Automation Bot with AI-powered responses",
"version": "0.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/nithin434/woat/issues",
"Documentation": "https://github.com/nithin434/woat/wiki",
"Homepage": "https://github.com/nithin434/woat",
"Source Code": "https://github.com/nithin434/woat"
},
"split_keywords": [
"whatsapp",
" instagram",
" bot",
" automation",
" ai",
" chat",
" messaging",
" api"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6a61a7b51acd210bedce651e9a860f92b01dfeb5d3c1c59f2a281333c50f38e2",
"md5": "9b1b3fbc95ee7d6286b80c7d974ab932",
"sha256": "24bb68b7ea35267846f5edb47576d820a5c9ca9616da383883d2c2e36fcbfbc1"
},
"downloads": -1,
"filename": "watbot-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9b1b3fbc95ee7d6286b80c7d974ab932",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 42708,
"upload_time": "2025-10-19T13:37:48",
"upload_time_iso_8601": "2025-10-19T13:37:48.806685Z",
"url": "https://files.pythonhosted.org/packages/6a/61/a7b51acd210bedce651e9a860f92b01dfeb5d3c1c59f2a281333c50f38e2/watbot-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d52d806803b1a048242832096de3ff1e08077be5db1273f0e156c0a6f29e800d",
"md5": "0f0d6b590558ee5d254de260c50de58a",
"sha256": "d2d76bda3fc29da028fce42d19486174f677f31c2645dd7115ce4b708f332195"
},
"downloads": -1,
"filename": "watbot-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "0f0d6b590558ee5d254de260c50de58a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 56219,
"upload_time": "2025-10-19T13:37:50",
"upload_time_iso_8601": "2025-10-19T13:37:50.243676Z",
"url": "https://files.pythonhosted.org/packages/d5/2d/806803b1a048242832096de3ff1e08077be5db1273f0e156c0a6f29e800d/watbot-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-19 13:37:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nithin434",
"github_project": "woat",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "playwright",
"specs": [
[
">=",
"1.40.0"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
">=",
"1.0.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.31.0"
]
]
},
{
"name": "fastapi",
"specs": [
[
">=",
"0.104.1"
]
]
},
{
"name": "uvicorn",
"specs": [
[
">=",
"0.24.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.4.2"
]
]
},
{
"name": "google-generativeai",
"specs": [
[
">=",
"0.3.0"
]
]
},
{
"name": "aiohttp",
"specs": [
[
">=",
"3.9.0"
]
]
},
{
"name": "aiosmtplib",
"specs": [
[
">=",
"2.0.2"
]
]
},
{
"name": "python-multipart",
"specs": [
[
">=",
"0.0.6"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"7.0"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
">=",
"3.0"
]
]
},
{
"name": "pytest-asyncio",
"specs": [
[
">=",
"0.21.1"
]
]
},
{
"name": "black",
"specs": [
[
">=",
"22.0"
]
]
},
{
"name": "flake8",
"specs": [
[
">=",
"4.0"
]
]
},
{
"name": "mypy",
"specs": [
[
">=",
"0.950"
]
]
},
{
"name": "build",
"specs": [
[
">=",
"1.0.3"
]
]
},
{
"name": "twine",
"specs": [
[
">=",
"4.0.2"
]
]
}
],
"lcname": "watbot"
}
JSON
