---

A WhatsApp bot with rich and multiple features created by Carlymaxx.

CURRENT BOT VERSION ➜ v3.2.0 ⚡

---

🚀 Get Started

_{⭐ Don't forget to FORK 🍴 and STAR 🌟 the repo to support the project!}

_{⭐ Recommended — one click, done in 2 minutes}

_{Free tier available — great for testing}

_{Free hosting with auto-deploy from GitHub}

_{Run directly on your Android phone 24/7}

---

📊 Repo Stats

     

     

---

⚡ Features

---

🌐 Community & Links

Get bot updates, new features & announcements	Join the community — get help & share configs
Follow us on Telegram for extra updates	Watch tutorials & bot demos on YouTube
Visit our website for more tools & resources	Generate your free SESSION ID here — takes 30 seconds

---

🎬 Watch Tutorials

Subscribe to our YouTube channel for all updates

Step-by-step guide to get & set up MAXX-XMD

How to deploy MAXX-XMD on your own VPS or server

---

🚀 Deployment Options

Deploy on Heroku, Railway, Render, Docker/VPS, Termux, or Koyeb — your choice.

---

1️⃣ Heroku — One Click (Recommended)

1. Click Deploy on Heroku above
2. Get your free SESSION_ID below then paste it in the form:

3. Click Deploy App → Done in 2 minutes!

---

2️⃣ Docker (VPS / Katapump / Any Linux Server)

# 1. Clone the repo
git clone https://github.com/Carlymaxx/maxxtechxmd.git
cd maxxtechxmd

# 2. Copy environment file
cp docker/.env.example .env

# 3. Edit .env — paste your SESSION_ID
nano .env

# 4. Build and start
docker-compose -f docker/docker-compose.yml up -d

# 5. View logs
docker-compose -f docker/docker-compose.yml logs -f

---

3️⃣ VPS / Katapump — Manual Node.js

Requirements: Node.js 20+, pnpm

# 1. Clone
git clone https://github.com/Carlymaxx/maxxtechxmd.git
cd maxxtechxmd

# 2. Install dependencies
npm install -g pnpm
pnpm install

# 3. Set your SESSION_ID
export SESSION_ID="MAXX-XMD~H4sI...your-session..."
export BOT_NAME="MAXX-XMD"

# 4. Run the bot
node --enable-source-maps ./artifacts/carlymaxx-engine/dist/index.mjs

Keep it running 24/7 with PM2:

npm install -g pm2
pm2 start "node ./artifacts/carlymaxx-engine/dist/index.mjs" --name maxx-xmd
pm2 save && pm2 startup

---

4️⃣ Railway / Render / Koyeb

1. Fork this repo
2. Connect your GitHub to Railway / Render / Koyeb
3. Set SESSION_ID as an environment variable
4. Deploy — done!

---

⚡ Tips

iPhone users: If any button says "Download" instead of opening, try long-pressing → Open in New Tab

Android users: All buttons open instantly!

---

🔑 Get Your Session ID

Visit pair.maxxtech.co.ke — enter your WhatsApp number, scan QR or enter pairing code, copy the Session ID. It's 100% FREE.

---

⚙️ Environment Variables

Variable	Required	Description
SESSION_ID	✅ Yes	WhatsApp session — from pair.maxxtech.co.ke
BOT_NAME	No	Bot display name (default: MAXX-XMD)
PREFIX	No	Command prefix (default: .)
WORK_MODE	No	public or private (default: public)
OWNER_NUMBER	No	Your WhatsApp number e.g. 254712345678
PAYSTACK_SECRET_KEY	No	For M-Pesa STK push payments

---

👑 Contributors

Carlymaxx 👑 CEO & Lead Developer

Fork the repo and open a Pull Request

Found a bug? Let us know via Issues

Suggest a new command or improvement

---

📌 Made with ❤️ by Carlymaxx ⚡

MAXX-XMD v3.2.0 — The most powerful Kenyan WhatsApp bot