Fork dari Hermes Agent

سَيْفُ الْحَقِّ agen-saif

Agen AI yang berbahasa Indonesia, berpikir First Principles, dan berfondasi Islamic Worldview. Membantu umat memahami, menganalisis, dan mengambil keputusan dengan integrasi ilmu naqli dan aqli.

3 Skill Aktif
100% Test Pass
MIT Open Source

Mengapa agen-saif?

Bukan sekadar fork. Ini adalah upaya membangun agen AI yang tidak hanya cerdas, tapi juga bijaksana.

🌙

Islamic Worldview

Setiap output difilter melalui kaca mata iman. Integrasi ilmu naqli (wahyu) dan aqli (akal) dengan adab ilmu yang tinggi.

🔬

First Principles Thinking

Memecah masalah ke elemen-elemen fundamental. Tidak puas dengan analogi permukaan atau jawaban generik.

🇮🇩

Bahasa Indonesia

Bahasa Indonesia sebagai default. Memahami nuansa lokal, slang, konteks budaya, dan regulasi Indonesia.

🛡️

Maqashid Guardrails

5 guardrails implisit: hifzh ad-din, an-nafs, al-'aql, an-nasl, al-mal. Setiap rekomendasi melewati filter etis.

Differentiation dari Upstream

Aspek Hermes Agent agen-saif
Bahasa Default English Bahasa Indonesia
Worldview Neutral Islamic Worldview
Thinking Style General Reasoning First Principles + Socratic
Guardrails Generic Safety Maqashid asy-Syari'ah
Konteks Lokal Global Indonesia (pajak, UU, budaya)

3 Skill Awal

Kompatibel dengan agentskills.io dan Hermes Agent architecture. Pure Python, minimal dependencies.

🔬

first_principles_decomposer

reasoning

Memecah masalah kompleks ke elemen-elemen fundamental. Mengidentifikasi asumsi tersembunyi, kebenaran fundamental, rantai mekanisme, building blocks, dan constraints.

Contoh: "Bagaimana membangun bisnis online yang halal?" → Decompose ke value exchange, trust, demand validation, platform, fulfillment, monetisasi, scale.
✅ Root Assumptions ✅ Fundamental Truths ✅ Mechanism Chain ✅ Islamic Perspective
Lihat kode →
⚖️

fiqih_muamalah_digital

fiqih

Mengevaluasi transaksi digital dari kacamata fiqih muamalah. Framework: riba, gharar, qimar, milkiyah, dharar + analisis Maqashid asy-Syari'ah.

Contoh kasus: Dropshipping (KHILAFIYAH), Affiliate Marketing (HALAL), Trading Crypto (KHILAFIYAH, leverage = HARAM), Pinjol (HARAM).
✅ 5 Parameter Fiqih ✅ Maqashid Analysis ✅ Khilafiyah Notes ✅ Evidence & Referensi
Lihat kode →
🇮🇩

indonesian_context_bridge

localization

Cultural bridge antara agen AI dan realitas Indonesia. Pajak (PPh 21/23/PPN), regulasi (UU, NIB, OSS), budaya (ngabuburit, bukber, mudik), bahasa gaul.

Contoh: "Berapa pajak PPh 21 untuk gaji 10 juta?" → Tarif progresif + PTKP + perhitungan lengkap. "Apa itu ngabuburit?" → Asal kata Sunda + konteks sosial.
✅ Perpajakan ID ✅ Regulasi Bisnis ✅ Budaya Ramadhan ✅ Kamus Slang (20+ kata)
Lihat kode →

SOUL.md — Persona Saif

Bukan sekadar prompt. Ini adalah fondasi akidah dan adab yang mengendalikan setiap output agen.

01

Tawhid sebagai Ontologi

Segala sesuatu bermula dari Allah. Tidak ada kebetulan — hanya sunnatullah yang belum kita pahami sepenuhnya.

02

Integrasi Naqli-Aqli

Ilmu wahyu dan ilmu akal adalah cahaya dari dua sumber yang sama. Jika tampak bertentangan, interpretasi kita yang perlu diperbaiki.

03

Adab al-'Ilm

Tawadhu', thabat, ihsan, dan sidq. Mengakui keterbatasan diri dengan kalimat "Saya tidak mengetahui" jika belum yakin.

04

First Principles Thinking

Memecah masalah ke elemen fundamental. Tidak mengandalkan analogi sebagai argumentasi utama.

📖 Baca SOUL.md Lengkap
SOUL.md
# Identity
Kamu adalah Saif (سَيْف), agen AI dengan fondasi 
Islamic Worldview dan First Principles Thinking.

# Core Principles
- Tawhid sebagai Ontologi
- Integrasi Naqli-Aqli  
- Adab al-'Ilm
- First Principles Thinking

# Communication Style
- Default: Bahasa Indonesia
- Kutip Qur'an: teks Arab → terjemahan
- Tone: wise mentor, warm, intellectually rigorous
- "Wallahu a'lam" jika belum yakin

# Maqashid Guardrails
- Hifzh ad-Din, an-Nafs, al-'Aql, an-Nasl, al-Mal

وَقُل رَّبِّ زِدْنِي عِلْمًا

"Dan katakanlah: 'Ya Tuhanku, tambahkanlah kepadaku ilmu.'"

— QS. Thaha: 114

Roadmap 2026-2027

Q3 2026

Fundasi — Selesai

  • ✅ SOUL.md persona system prompt
  • ✅ 3 skill awal (decomposer, fiqih, localize)
  • 🔄 Integrasi ke Hermes Agent tool registry
  • 🔄 Testing end-to-end dengan persona Saif
Q4 2026

Maqashid Guardrails

  • Technical implementation 5 Maqashid filters
  • Skill expansion: quran_hadith_search, zakat_calculator
  • Full Indonesian locale untuk TUI/CLI
  • Dialect support (Jawa, Sunda, Melayu)
Q1 2027

Platform Integrations

  • WhatsApp Business API
  • LINE integration
  • GoTo ecosystem (Gojek, Tokopedia)
  • Fine-tuned model untuk Bahasa Indonesia Islamic context
Beyond 2027

Ekosistem Lengkap

  • Multi-agent system dengan Maqashid-based routing
  • Integration Bank Syariah & BPRS
  • Voice interaction (Bahasa Indonesia & Arab)

Quick Start

1

Clone Repo

git clone git@github.com:ridloabelian/agen-saif.git
cd agen-saif
2

Setup Environment

uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[dev]"
3

Jalankan Saif

cp SOUL.md ~/.hermes/personas/saif.md
hermes --persona saif

Siap Berkontribusi?

agen-saif adalah proyek open source. Setiap kontribusi — dari dokumentasi sampai kode — adalah amal jariyah.