Lilith
WhatsApp Bot Built With Python
Install / Use
/learn @ZhanNexus/LilithREADME
🌟 About Lilith
Lilith is an advanced WhatsApp bot meticulously crafted with Python and asynchronous technology for optimal performance. Designed to revolutionize your WhatsApp automation experience, this bot combines cutting-edge functionality with elegant design.
✨ Key Features
<div align="center">| 🚀 Performance | 🔧 Customization | 📱 Integration | |:---:|:---:|:---:| | Asynchronous architecture for lightning-fast responses | Modular design for easy customization | Seamless WhatsApp API integration |
| ⚡ Responsiveness | 📥 Media Handling | 🔐 Security | |:---:|:---:|:---:| | Real-time processing with minimal latency | Advanced media processing capabilities | Secure environment configuration |
</div>🎯 Core Capabilities
- Message Processing: Sophisticated message parsing and handling
- Media Management: Advanced media upload and download capabilities
- Database Integration: Robust SQLite and PostgreSQL support
- Event Handling: Comprehensive event-driven architecture
- Plugin System: Extensible plugin architecture for easy feature additions
📊 GitHub Stats
<div align="center">📚 Quick Start
Prerequisites
<div align="center">
Installation
Step-by-Step Setup
-
Clone the Repository
git clone https://github.com/ZulX88/lilith.git cd lilith -
Install Dependencies
pip install -r requirements.txt -
Configure Environment
cp .env.example .env # Edit .env with your configurations -
Generate Session
python3 gen.py -
Run the Bot
python3 -m bot
⚠️ Note: Follow the instructions that appear during session generation to connect with your WhatsApp.
⚙️ Configuration
Environment Variables
PREFIXES=/,.,! #Prefix for bot
NAMEDB=db.sqlite3 # Name database file, can use postgresql. Just add postgresql link
OWNER=62xxx,84xxx # Owner bot
BOT_NAME=Shiro Bot # Name bot
NAUVAL_APIKEY=xxxxxxxxx #Nauval ytdl apikey
GITHUB_TOKEN=gh_patxxxxxxx # GitHub PAT
OLLAMA_APIKEY=xxxxx # AI Ollama Cloud
| <kbd>Variable</kbd> | <b>Description</b> | <b>Default</b> |
|:-------------------:|:-----------------:|:-------------:|
| PREFIXES | Command prefixes for the bot | / |
| NAMEDB | Database file name | db.sqlite3 |
| OWNER | Owner numbers (comma-separated) | 62xxx,84xxx |
| BOT_NAME | Display name for the bot | Lilith Bot |
🗂️ Project Structure
lilith/
├── bot/ # 🤖 Core Package
│ ├── __init__.py # 🧩 Package initializer
│ ├── __main__.py # 🖥️ Main bot entry point
│ ├── handler.py # 🤖 Message handler
│ ├── config.py # ⚙️ Configuration settings
│ ├── lib/ # 🧩 Core library modules
│ │ ├── func.py # 🛠️ Function
│ │ ├── serialize.py # 📬 Message serialization
│ │ └── msg_store.py # 📦 Database store logic
│ ├── database/ # 📁 Database & JSON Storage
│ └── plugins/ # 🔌 Bot plugins directory
├── .env # 🔐 Environment variables
├── requirements.txt # 📦 Python dependencies
└── gen.py # 🔐 Session generation script
🧩 Available Plugins
<div align="center">| Plugin Category | Functionality | Status | |----------------|---------------|--------| | 📥 Downloader | Media download capabilities | ✅ Active | | 🧩 General | Basic bot commands | ✅ Active | | 🎵 Music | Music search and download | ✅ Active | | 🤖 AI | Artificial intelligence features | ✅ Active |
</div>🤝 Contribution
<div align="center">
We warmly welcome your contributions! To contribute:
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
🌟 Contributors
<a href="https://github.com/ZulX88/lilith/graphs/contributors"> <img src="https://contrib.rocks/image?repo=ZulX88/lilith" alt="Contributors" /> </a> </div>🙏 Acknowledgments
- Special thanks to @Nubuki-all for the amazing documentation! 🙏
- Inspired by the open-source community and developers worldwide 💙
- Built with neonize framework 🚀
📞 Connect with Me
<div align="center"><img src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"> <img src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram"> <img src="https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white" alt="Twitter"> <img src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white" alt="Instagram">
</div>💰 Donation
<div align="center">Buy me a coffee: <img src="https://img.shields.io/badge/Saweria-FFA500?style=for-the-badge&logo=Buy+Me+A+Coffee&logoColor=white" alt="Saweria"> <img src="https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white" alt="Ko-fi">
</div><div align="center">
