Limkid‑X — Modern WhatsApp Bot

Limkid‑X — a powerful, multi‑feature WhatsApp automation bot for groups, media tools, moderation and more. Deploy in minutes and run like an app.

---

Quick Preview

---

Key Features

• App-like, easy-to-follow setup and deployment
• Pairing (SESSION_ID) or QR pairing UI for quick bot login
• Group management: moderation, welcome/leave messages, anti-spam
• Media tools: image/audio processing, sticker creation, converters
• Automation: scheduled tasks, auto‑reply, command handlers
• Plugin-friendly: extend commands and modules easily

---

Pairing & Sessions

You can pair your WhatsApp session using either the Pairing website (session ID) or the QR Pair:

• Pairing website (session ID): https://pairlimkid-f0adcc9718da.herokuapp.com/pair
  Click the link, copy the displayed Session ID and add it to your environment variables as SESSION_ID.

• QR Pair (scan with your phone): https://pairlimkid-f0adcc9718da.herokuapp.com/qr

Important: Keep your session ID private — treat it like a password.

---

Installation & Deployment (App‑style)

Choose Heroku, Render or GitHub Actions.

1) Fork the repository

Fork to your account: https://github.com/jayvon33/limkid-X/fork

2) Configure environment variables

Set these config vars / secrets on your host:

• SESSION_ID — (required) the session ID you obtained
• OWNER_NUMBER — your WhatsApp number (e.g., +13045593649)
• PREFIX — command prefix (e.g. ! or /)
• PORT — (if required)
• NODE_ENV — production

3) One-click Deploys

• Heroku: use the button above, supply env vars and deploy.
• Render: use the Render button above and follow deploy steps.
• GitHub Actions: create .github/workflows/main.yml (example below) and add secrets to repository settings.

Example GitHub Actions workflow:

name: Deploy Limkid-X (CI)

on:
  push:
    branches: [ main ]
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [20.x]

    steps:
      - uses: actions/checkout@v3
      - name: Use Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}
      - name: Install dependencies
        run: npm install --legacy-peer-deps
      - name: Start
        run: npm start

4) Run locally

1. Clone your fork:
   • git clone https://github.com//limkid-X.git
2. Install:
   • npm install
3. Create a .env with required values (or use environment variables)
4. Start:
   • npm start

---

Quick Commands (examples)

• /help — Show list of commands and usage
• /sticker — Convert image to sticker
• /ban @user — Ban a user (group admin only)
• /welcome on|off — Toggle welcome messages
• /setprefix — Change bot command prefix (owner only)

(Replace with the full command list from your bot's code — consider adding a Commands.md later.)

---

Contact & Community

All clickable social badges below open the corresponding link or chat.

• Telegram (Developer / Support):
  

• Telegram (Group / Channel):
  

• Instagram:
  

• WhatsApp (Owner):
  

• WhatsApp (Support):
  

Other links:

• Repo (Limkid‑X): https://github.com/jayvon33/limkid-X
• Fork this repo: https://github.com/jayvon33/limkid-X/fork
• Issues / Bug Reports: https://github.com/jayvon33/limkid-X/issues

Phone numbers (plain text):

• Owner WhatsApp: +1 (304) 559-3649
• Support (WhatsApp): +233 50 431 4086

---

Screenshots & Demo

Add screenshots or short GIFs showing:

• Pairing flow (pair site & QR)
• Example bot responses in a group
• Sticker/media conversion examples

---

Security & Privacy

• Keep your SESSION_ID secret and store it in Config Vars or Secrets.
• Do not share your session ID publicly.
• Use responsibly and follow WhatsApp Terms of Service.

---

Contributing

We welcome contributions:

1. Fork the repo
2. Create a feature branch
3. Open a PR describing your change
4. Add tests and documentation for new features

For plugin authors: add a plugin folder with README, example commands, and export an init function the bot loads.

---

License

This repository currently has no license file. Add a LICENSE (e.g., MIT) if you want others to reuse your code.

---

Thank you for using Limkid‑X — deploy fast, manage smarter, and customize your WhatsApp experience.

2..DEPLOY ON RENDER ⤵️

3..DEPLOY ON GITHUB ⤵️

Deploy On Workflow

Copy the workflow codes and then frok the repo edit config add session id then save and now click on repo action tag then click on start new workflow then paste workflow codes rename main.yml to deploy.yml and save the file

Important

Attention! We do not take responsibility if your github account is suspended through this Deploy method, I advise you not to use this workflow deploy method in the latest github accounts, github accounts created a year or more ago have not received the risk of suspension so far, this works It will only be done for 6 hours, you need to update the code to reactivate it.

name: Node.js CI

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  build:

    runs-on: ubuntu-latest

    strategy:
      matrix:
        node-version: [20.x]

    steps:
    - name: Checkout repository
      uses: actions/checkout@v3

    - name: Set up Node.js
      uses: actions/setup-node@v3
      with:
        node-version: ${{ matrix.node-version }}

    - name: Install dependencies
      run: npm install

    - name: Start application
      run: npm start

Thank You Dear

DEVELOPER OF Limkid-X

• LIMKID-X
• Creater and Owner Of Limkid-X

Limkid-X Helper

• LIMKID-X
• For helping in bot plugin files.

---

# Limkid-X