Lewati ke isi

Kredit

Inspirasi

Guide ini diinspirasi langsung dari Hermes/Mahiru SOUL Guide — terima kasih ke pembuat guide tersebut atas pemikiran original tentang konsep SOUL untuk AI agent.

Yang gua ambil dari Mahiru: - Konsep 10 pilar terstruktur (Identity, Communication, Capabilities, dst) - File konstitusi terpisah (SOUL.md) sebagai source of truth - Kerangka berpikir untuk autonomy levels

Yang gua adaptasi / ubah: - Filosofi inti: dari "agent sebagai partisipan terpisah" → "akun user = akun agent" - Risk-gating: konkret per command dengan field risk di tool_use - Tool format: <tool_use>{...}</tool_use> XML+JSON hybrid - Communication tone: gue/lo informal Indonesia, plain text - Credential handling: folder terpisah dengan permission ketat - Anti-injection: pattern detection + content fencing eksplisit

Guide Mahiru cocok buat agent yang lebih korporat / multi-user. Guide ini cocok buat agent personal mode "perpanjangan tangan".

Stack & tools

  • MkDocs Material — generator dokumentasi
  • python-telegram-bot — Telegram framework
  • OpenAI Python SDK — LLM client (compatible dengan banyak proxy)
  • systemd — service manager Linux
  • AWS / Oracle / Hetzner — VPS hosting

Implementasi referensi

Kai — AI agent personal Gutluc. Source code private, tapi pola yang dipakai di-distill ke guide ini.

Spec Kai: - Stack: Python 3.12 + python-telegram-bot - VPS: AWS EC2 t3.micro (Ubuntu 24.04) - LLM: OpenAI proxy (configurable model) - File: ~/ai-agent/SOUL.md, ~/ai-agent/credentials/, ~/ai-agent/data/

Disclaimer

Guide ini berdasarkan pengalaman 1 deployment (Kai). Beberapa pola mungkin perlu adaptasi untuk: - Stack non-Python (Node.js, Go, Rust) - Platform non-Telegram (Discord, Slack, web UI) - Use case non-personal (multi-user, public chatbot)

Konsep core (10 pilar SOUL, risk-gating, credential by reference) berlaku universal.

Lisensi

Konten guide ini bebas dipakai dan dimodifikasi. Attribution appreciated tapi ga wajib.

Kalo lo bikin guide turunan dari ini, mention guide ini (atau Mahiru) supaya pembaca tau lineage konsepnya.

Kontribusi

Kalo lo mau kontribusi (fix typo, tambah section, share pengalaman): - Open issue / PR di repo guide (kalo public) - Atau fork dan maintain versi sendiri

Kontak

Pembuat guide: Gutluc (Teguh Gustiana Nur Fadhilah)

Pertanyaan atau request: - GitHub: dukunline-cyber - Telegram: @gutluc (atau via comment di guide kalo platform support)

Versi

Versi Tanggal Catatan
1.0 2026-05-14 Initial release: 10 pilar + tutorial + VPS gratis

Guide ini live document. Update sesuai pengalaman + feedback komunitas.

Terakhir

Bikin agent yang punya SOUL itu bukan cuma soal teknis — itu soal filosofi. Lo decide siapa agent lo, apa yang dia boleh dan ga boleh lakuin, kapan dia tanya kapan dia eksekusi.

Guide ini cuma starting point. Sisanya tergantung lo.

Selamat ngebangun. Semoga agent lo serve lo well.