Skip to main content

WhatsApp & Instagram Automation Bot with AI-powered responses

Project description

WATBOT - WhatsApp & Instagram Automation Bot

Quick Links

Installation & Usage

Method 1: Interactive (Easiest)

python start.py

Follow the prompts!

Method 2: Python Script

from watbot import WhatsAppBot

bot = WhatsAppBot()
bot.start()

Method 3: Command Line

watbot start

Method 4: Custom Config

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

# 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

License

MIT License - see LICENSE


Made with ❤️ by Nithin Jambula

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

watbot-0.1.1.tar.gz (56.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

watbot-0.1.1-py3-none-any.whl (42.7 kB view details)

Uploaded Python 3

File details

Details for the file watbot-0.1.1.tar.gz.

File metadata

  • Download URL: watbot-0.1.1.tar.gz
  • Upload date:
  • Size: 56.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for watbot-0.1.1.tar.gz
Algorithm Hash digest
SHA256 d2d76bda3fc29da028fce42d19486174f677f31c2645dd7115ce4b708f332195
MD5 0f0d6b590558ee5d254de260c50de58a
BLAKE2b-256 d52d806803b1a048242832096de3ff1e08077be5db1273f0e156c0a6f29e800d

See more details on using hashes here.

Provenance

The following attestation bundles were made for watbot-0.1.1.tar.gz:

Publisher: publish.yml on nithin434/woat

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file watbot-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: watbot-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 42.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for watbot-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 24bb68b7ea35267846f5edb47576d820a5c9ca9616da383883d2c2e36fcbfbc1
MD5 9b1b3fbc95ee7d6286b80c7d974ab932
BLAKE2b-256 6a61a7b51acd210bedce651e9a860f92b01dfeb5d3c1c59f2a281333c50f38e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for watbot-0.1.1-py3-none-any.whl:

Publisher: publish.yml on nithin434/woat

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page