nirwabot

KO | EN

gitlite — search

#hacktoberfest #react #typescript #go #android #machine-learning #linux #macos #nodejs #java #windows #pytorch #mcp #openai

(★ 165)

Useless WhatsApp Bot

File Explorer

Download Latest Version (.zip)

- - chatgpt.js
  - claude.js
  - copilot.js
  - deepseek.js
  - felo.js
  - flux.js
  - gemini.js
  - nanobanana.js
  - notrack.js
  - perplexity.js
  - pollinations.js
  - qwen.js
  - venice.js
- - sticker.js
  - stickerwm.js
  - toaudio.js
  - togif.js
  - toimage.js
  - tovid.js
- - facebookdl.js
  - instagramdl.js
  - pinterestdl.js
  - play.js
  - spotifydl.js
  - telegramstickerdl.js
  - tiktokdl.js
  - youtubedl.js
- - cerdascermat.js
  - coinflip.js
  - dice.js
  - family100.js
  - gamble.js
  - hangman.js
  - maths.js
  - quiz.js
- - group.js
  - groupstatus.js
  - intro.js
  - link.js
  - list.js
  - member.js
  - mute.js
  - pending.js
  - role.js
  - setdescription.js
  - setmaxwarnings.js
  - setname.js
  - setoption.js
  - setpp.js
  - settext.js
  - simulate.js
  - tag.js
  - top.js
  - warning.js
- - about.js
  - botgroup.js
  - donate.js
  - listapis.js
  - owner.js
  - ping.js
  - price.js
  - sc.js
  - server.js
  - speedtest.js
  - tqto.js
  - uptime.js
- - menu.js
- - brat.js
  - iphonequotedchat.js
  - quotlychat.js
  - stickermeme.js
- - collector.js
  - getinput.js
  - getpp.js
  - readviewonce.js
- - addcoinuser.js
  - ban.js
  - broadcast.js
  - checkapis.js
  - eval.js
  - exec.js
  - join.js
  - label.js
  - list.js
  - mode.js
  - osettext.js
  - premium.js
  - restart.js
  - setbotcover.js
  - setbotname.js
  - setbotpp.js
  - sewa.js
- - afk.js
  - autodownload.js
  - claim.js
  - coin.js
  - leaderboard.js
  - level.js
  - profile.js
  - reset.js
  - transfer.js
  - xp.js
- - spotifysearch.js
  - tiktoksearch.js
  - youtubesearch.js
- - alkitab.js
  - alquran.js
  - bypassshortlink.js
  - createqrcode.js
  - fetch.js
  - hd.js
  - lyric.js
  - ocr.js
  - pinterest.js
  - removebackground.js
  - scanqrcode.js
  - screenshot.js
  - translate.js
  - upload.js
- call.js
- index.js
- messages.js
- ready.js
- welcome.js
- api.js
- client.js
- collector.js
- config.js
- cooldown.js
- ctx.js
- format.js
- group.js
- handler.js
- helper.js
- index.js
- list.js
- check.js
- index.js
- permissions.js
- restrictions.js
- track.js
.env
.gitignore
config.example.json
Dockerfile
index.js
LICENSE
main.js
package.json
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">✦ nirwabot ✦</h1>

Useless WhatsApp Bot — Because Why Not?

---

## 📖 About

**nirwabot** adalah bot WhatsApp yang dirancang untuk menjadi teman digital serbaguna — mulai dari membuat stiker, menjawab pertanyaan dengan AI, hingga bermain game interaktif. Meskipun disebut _"useless"_, bot ini hadir dengan segudang fitur yang (mungkin) berguna untuk keseharianmu.

### 🧠 Philosophy of Names

| Bagian  | Arti                                                                                      |
| ------- | ----------------------------------------------------------------------------------------- |
| **Nir** | Berasal dari bahasa Sanskerta yang berarti **"tidak ada"**, **"tanpa"**, atau **"bebas"** |
| **Wa**  | Singkatan dari **WhatsApp**                                                               |
| **Bot** | Merujuk pada **Robot** atau program otomatis                                              |

> Secara keseluruhan, **nirwabot** bermakna _"Bot WhatsApp yang bebas (tanpa batasan)"_ — sebuah representasi dari semangat open-source yang memberi kebebasan kepada pengguna untuk mengeksplorasi dan mengembangkan sesuai kebutuhan.

---

> [!WARNING]
>
> ## ⚠️ Important Warning
>
> `nirwabot` **tidak berafiliasi dengan WhatsApp, Meta, atau pihak terkait mana pun**. Proyek ini adalah **perangkat lunak sumber terbuka** yang dibuat untuk tujuan edukasi dan pengembangan.
>
> Bot ini menggunakan **API WhatsApp tidak resmi**, yang berarti **akun WhatsApp Anda berpotensi diblokir** oleh WhatsApp. Gunakan dengan bijak dan di bawah tanggung jawab Anda sendiri.
>
> **Kami tidak bertanggung jawab atas penyalahgunaan, kerusakan, atau pemblokiran akun** yang mungkin terjadi.

---

## 🚀 Starting

### 📋 Requirements

- **Node.js** ≥ 20
- **npm** atau **yarn** atau **pnpm**
- **Git**

### 1️⃣ Clone

```bash
git clone https://github.com/itsreimau/nirwabot.git
cd nirwabot
```

### 2️⃣ Install & Setup

```bash
npm run setup
```

Atau manual:

```bash
npm install
cp config.example.json config.json
```

### 3️⃣ Configuration

Buka dan edit `config.json` sesuai kebutuhan:

- **Bot Identity** — Nama, nomor HP, thumbnail, dan link grup
- **Owner Settings** — Nama, nomor, dan co-owner
- **System Settings** — Mode bot, fitur keamanan, batasan, dan lainnya
- **Message Settings** — Pesan default untuk berbagai situasi
- **Sticker Settings** — Packname dan author untuk stiker

---

## ▶️ Running

| Mode               | Perintah               | Deskripsi                            |
| ------------------ | ---------------------- | ------------------------------------ |
| 🧪 **Development** | `npm start`            | Jalankan di terminal untuk debugging |
| 🚀 **Production**  | `npm run start:pm2`    | Jalankan sebagai background service  |

### 🔐 Authentication

| Metode           | Langkah                                                                             |
| ---------------- | ----------------------------------------------------------------------------------- |
| **Pairing Code** | Kode 8 digit muncul di terminal → Buka WhatsApp > Perangkat Tertaut → Masukkan kode |
| **QR Code**      | QR Code muncul di terminal → Buka WhatsApp > Perangkat Tertaut → Pindai QR          |

---

## 🛠️ Creating a New Command

Untuk menambahkan perintah kustom, buat file JavaScript baru di folder `commands/` dengan struktur berikut:

```javascript
// commands/example/helloworld.js

module.exports = {
    name: "helloworld", // Nama perintah (wajib)
    aliases: ["hello", "hw"], // Alias (opsional)
    category: "example", // Kategori (opsional)
    permissions: { // Izin (opsional)
        admin: false, // Hanya admin grup?
        botAdmin: false, // Bot harus admin?
        coin: 0, // Biaya koin
        group: false, // Hanya di grup?
        owner: false, // Hanya owner?
        premium: false, // Hanya premium?
        private: false, // Hanya private chat?
        restrict: false // Mode restriktif?
    },
    code: async (ctx) => {
        await ctx.reply("Hello, World! 👋"); // Kirim pesan
        await ctx.replyReact("✨"); // Kirim reaksi
    }
};
```

---

## 🤝 Contribution

### Contribution Guidelines

1. **Fork** repositori ini
2. Buat **branch** baru (`git checkout -b fitur-keren`)
3. **Commit** perubahan (`git commit -m '✨ Menambahkan fitur keren'`)
4. **Push** ke branch (`git push origin fitur-keren`)
5. Buat **Pull Request**

### Contribution Rules

- ✅ Ikuti gaya kode yang sudah ada
- ✅ Tambahkan dokumentasi untuk fitur baru
- ✅ Uji coba sebelum mengirim PR
- ✅ Gunakan pesan commit yang deskriptif
- ❌ Jangan menghapus credit/attribution

---

## 🙏 Thanks to Contributors

Terima kasih kepada semua pihak yang telah berkontribusi:

<table>
<tr>
<td align="center">
 <a href="https://github.com/itsreimau">
 <img src="https://github.com/itsreimau.png" width="60px" style="border-radius:50%">
 ItsReimau
 </a>
</td>
<td align="center">
 <a href="https://github.com/JastinXyz">
 <img src="https://github.com/JastinXyz.png" width="60px" style="border-radius:50%">
 Jastin Linggar Tama
 </a>
</td>
<td align="center">
 <a href="https://github.com/itsliaaa">
 <img src="https://github.com/itsliaaa.png" width="60px" style="border-radius:50%">
 Lia Wynn
 </a>
</td>
<td align="center">
 <a href="https://github.com/Kyluxx">
 <img src="https://github.com/Kyluxx.png" width="60px" style="border-radius:50%">
 Kyluxx
 </a>
</td>
<td align="center">
 <a href="https://github.com/SirKaff">
 <img src="https://github.com/SirKaff.png" width="60px" style="border-radius:50%">
 Sir Kafka
 </a>
</td>
<td align="center">
 <a href="https://github.com/fjrhub">
 <img src="https://github.com/fjrhub.png" width="60px" style="border-radius:50%">
 fjrhub
 </a>
</td>
</tr>
<tr>
<td align="center">
 <a href="https://github.com/Rippanteq7">
 <img src="https://github.com/Rippanteq7.png" width="60px" style="border-radius:50%">
 Rippanteq7
 </a>
</td>
<td align="center">
 <a href="https://github.com/fandyahmd">
 <img src="https://github.com/fandyahmd.png" width="60px" style="border-radius:50%">
 Fan
 </a>
</td>
<td align="center">
 <a href="https://github.com/lzif">
 <img src="https://github.com/lzif.png" width="60px" style="border-radius:50%">
 Luki Zainur
 </a>
</td>
<td align="center">
 <a href="https://github.com/anupamme">
 <img src="https://github.com/anupamme.png" width="60px" style="border-radius:50%">
 Anupam Mediratta
 </a>
</td>
</tr>
</table>

Dan semua kontributor lainnya yang tidak bisa disebutkan satu per satu 🌟

---

## 📄 License

Proyek ini dilisensikan di bawah [MIT License](LICENSE).

---

Dibuat dengan ❤️ oleh <a href="https://github.com/itsreimau">ItsReimau</a> dan para kontributor
 
 ✦ nirwabot — Useless WhatsApp Bot ✦

nirwabot

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

nirwabot

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README