> For the complete documentation index, see [llms.txt](https://docs.haikaldev.my.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.haikaldev.my.id/readme.md).

# AI-Haikaru

AI agent yang hidup di WhatsApp — ngobrol, membaca hampir semua lampiran, menulis dan menjalankan kode, sampai menayangkan website.

**AI-Haikaru** bukan chatbot tanya-jawab. Dia *agent*: menerima pesan, memutuskan sendiri tool apa yang perlu dipanggil, membaca hasil sungguhannya, lalu memutuskan langkah berikutnya — berulang sampai pekerjaannya selesai.

Semuanya lewat chat biasa, tanpa aplikasi tambahan.

```
Kamu : bikinin aku website portofolio, terus hostingin
Bot  : Udah tayang! 🌐 https://proj.haikaldev.my.id/site/masbro/portofolio/
```

## Mulai dari mana?

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🚀 Baru di sini</strong></td><td>Dari <code>git clone</code> sampai QR ter-scan — sekitar 10 menit.</td><td><a href="/tentang/instalasi.md">Instalasi dan Setup</a></td></tr><tr><td><strong>🤖 Apa ini sebenarnya</strong></td><td>Kenapa "agent" beda dari chatbot, arsitektur, dan filosofi desainnya.</td><td><a href="/tentang/tentang.md">Apa itu AI-Haikaru</a></td></tr><tr><td><strong>⌨️ Cari perintah</strong></td><td>Semua perintah <code>/</code> dan <code>.</code> beserta contoh kalimatnya.</td><td><a href="/referensi/perintah.md">Referensi Perintah</a></td></tr><tr><td><strong>🔧 Ada yang rusak</strong></td><td>Gejala → penyebab → solusi, semuanya dari kasus nyata.</td><td><a href="/referensi/troubleshooting.md">Troubleshooting</a></td></tr></tbody></table>

## Yang bisa dia lakukan

| Kategori        | Yang bisa dilakukan                                                                                |
| --------------- | -------------------------------------------------------------------------------------------------- |
| 💬 **Ngobrol**  | Percakapan natural, personality santai, ingat konteks per chat                                     |
| 🔍 **Mencari**  | Pencarian web sungguhan dengan URL sumber — dan mengaku terus terang kalau tidak bisa mencari      |
| 📎 **Lampiran** | PDF (termasuk hasil scan), Office, kode, gambar, video (ditonton per frame), audio (ditranskripsi) |
| 💻 **Coding**   | Workspace proyek yang bertahan; tulis → **jalankan** → baca error → perbaiki sendiri               |
| 🌐 **Hosting**  | Website statis tayang di URL publik `/site/<username>/<proyek>/`                                   |
| 🖼️ **Media**   | Generate gambar, stiker komposabel, edit teks di foto, video → MP3, unduh dari sosmed              |
| 👥 **Grup**     | Moderasi, polling asli WhatsApp, game, rekap & statistik, ekspor Excel                             |

## Empat langkah pertama

{% stepper %}
{% step %}

### Pasang

`git clone`, `npm install`, salin `.env.example` → `.env`. Panduan lengkapnya di [instalasi.md](/tentang/instalasi.md).
{% endstep %}

{% step %}

### Sambungkan otaknya

Minimal isi **salah satu** kunci provider: `GRIPHUB_API_KEY` ([Griphub](/koneksi-ai/griphub.md), primer) atau `API_KEY` ([OhhMyAgent](/koneksi-ai/ohhmyagent.md), cadangan). Tanpa satu pun, bot tidak bisa berpikir sama sekali.

Sangat disarankan sekalian isi `GEMINI_API_KEY_1` — tanpanya bot **tuli**, voice note tidak pernah terbaca. Key itu sekaligus menyalakan [pencarian web](/koneksi-ai/pencarian-web.md) dan jadi kaki terakhir rantai chat, jadi satu isian membuka tiga hal.
{% endstep %}

{% step %}

### Scan QR

`npm start` → QR muncul di terminal (dan di `http://localhost:3000/`) → scan dari **WhatsApp → Perangkat Tertaut**.
{% endstep %}

{% step %}

### Coba yang paling seru

Kirim ke bot: *"bikin project halo dunia pakai python, terus jalanin"*

Dia akan membuat workspace, menulis kodenya, **menjalankannya**, dan melaporkan hasil sungguhan — bukan tebakan.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Dokumentasi ini mengikuti **v2.1.1**. Riwayat perubahan lengkap ada di [changelog](/riwayat/changelog.md).
{% endhint %}

***

AI-Haikaru · [Repo](https://github.com/AnakTentara/AI-Haikaru) · dibuat oleh [Haikal Mabrur](https://github.com/AnakTentara) · Apache-2.0


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.haikaldev.my.id/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.