permerix 0.1.0__tar.gz

permerix-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daffa Farid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

permerix-0.1.0/MANIFEST.in

@@ -0,0 +1,19 @@
+# Yang IKUT ke dalam paket sumber (sdist).
+include README.md
+include LICENSE
+
+# Yang TIDAK BOLEH ikut, apa pun keadaannya.
+# Paket ini akan terbit ke PyPI dan bisa diunduh siapa saja - sekali sebuah
+# kunci ikut terkirim, ia harus dianggap bocor selamanya dan wajib dicabut.
+exclude .env
+exclude .env.*
+global-exclude .env
+global-exclude .env.*
+global-exclude *.key
+global-exclude *.pem
+global-exclude secrets.*
+global-exclude *.pyc
+global-exclude __pycache__/*
+prune contoh
+prune dist
+prune build

permerix-0.1.0/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: permerix
+Version: 0.1.0
+Summary: Pustaka Python resmi untuk layanan Permerix (model Nusa).
+Author: Daffa Farid
+License: MIT
+Project-URL: Homepage, https://github.com/Daffa7382466/permerix
+Project-URL: Repository, https://github.com/Daffa7382466/permerix
+Project-URL: Issues, https://github.com/Daffa7382466/permerix/issues
+Keywords: permerix,nusa,ai,bahasa-indonesia,nlp,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Indonesian
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Permerix
+
+Pustaka Python resmi untuk layanan **Permerix**.
+
+**Permerix** adalah nama layanannya; **Nusa** adalah nama model di dalamnya —
+hubungannya seperti Claude dengan Opus.
+
+Nusa adalah AI berbahasa Indonesia yang dibangun dari nol: mesin n-gram dan
+peleburan graf kata, tanpa jaringan saraf. Ia menyusun kalimatnya sendiri dan
+bisa mencari tahu ke internet ketika tidak tahu.
+
+**Tanpa dependensi.** `pip install permerix` tidak menarik paket lain apa pun —
+pustaka ini hanya memakai modul bawaan Python.
+
+---
+
+## Pasang
+
+```bash
+pip install permerix
+```
+
+## Pakai
+
+```python
+from permerix import Permerix
+
+klien = Permerix(kunci="prx-live-xxxx")
+
+print(klien.tanya("apa itu kalimat efektif"))
+```
+
+Alamat layanan sudah tertanam di pustaka, jadi kamu tidak perlu mengaturnya.
+
+### Jawaban lengkap
+
+```python
+balasan = klien.percakapan.kirim("apa itu pantun")
+
+print(balasan.isi)
+print(balasan.kredit)        # kredit yang terpakai
+print(balasan.sisa_kredit)   # sisa; None berarti tanpa batas
+```
+
+### Mengalir
+
+```python
+for potong in klien.percakapan.alirkan("ceritakan tentang pantun"):
+    print(potong.isi, end="", flush=True)
+```
+
+### Cek kredit dan model
+
+```python
+klien.kredit()   # {'kredit': 98, 'peran': 'user', 'pesan': 2, ...}
+klien.model()    # [{'id': 'nusa-0.2', 'nama': 'Nusa 0.2', ...}]
+```
+
+---
+
+## Dari baris perintah
+
+```bash
+export PERMERIX_API_KEY=prx-live-xxxx
+
+permerix "apa itu kalimat efektif"
+permerix --alir "ceritakan tentang pantun"
+permerix --kredit
+permerix --daftar-model
+```
+
+Atau tanpa memasang perintahnya: `python -m permerix "halo"`
+
+---
+
+## Mengambil kunci
+
+Kunci API diambil lewat **bot Telegram** Permerix:
+
+1. Buka botnya, tekan `/start`
+2. Tekan tombol **Key** → **Buat Kunci**
+3. Salin kunci `prx-live-...`
+
+Pengguna baru mendapat **100 kredit gratis**. Satu pesan biasanya 1 kredit,
+naik sampai 5 bila Nusa perlu mencari ke internet.
+
+---
+
+## Pengaturan
+
+| Peubah lingkungan | Guna |
+|---|---|
+| `PERMERIX_API_KEY` | kunci API, supaya tidak perlu ditulis di kode |
+| `PERMERIX_API_URL` | alamat layanan; menimpa alamat bawaan pustaka |
+
+```python
+# Semua pengaturan bisa juga diberikan langsung
+klien = Permerix(
+    kunci="prx-live-xxxx",
+    alamat="https://api.contoh.com",   # opsional
+    tenggang=180,                       # detik
+    coba_ulang=2,                       # ulangi bila jaringan gagal
+)
+```
+
+---
+
+## Menangani kesalahan
+
+```python
+from permerix import Permerix, KreditHabis, TerlaluCepat, GalatPermerix
+
+try:
+    print(klien.tanya("halo"))
+except KreditHabis:
+    print("Kredit habis, isi ulang lewat bot Telegram.")
+except TerlaluCepat as e:
+    print(f"Terlalu cepat, tunggu sebentar. {e.pesan}")
+except GalatPermerix as e:
+    print(f"Gagal ({e.kode}): {e.pesan}")
+```
+
+Semua kesalahan turunan `GalatPermerix`, jadi satu blok `except` sudah cukup.
+
+| Kesalahan | Kapan |
+|---|---|
+| `GalatKunci` | kunci salah, tidak ada, atau sudah dicabut |
+| `KreditHabis` | kredit sudah nol |
+| `TerlaluCepat` | melewati batas laju |
+| `ModelDitolak` | model belum dirilis atau perlu peran lebih tinggi |
+| `GalatJaringan` | server tidak bisa dihubungi |
+| `GalatLayanan` | server bermasalah di sisinya |
+
+---
+
+## Model
+
+| Model | Keterangan |
+|---|---|
+| `nusa-0.2` | model bawaan, sudah dirilis |
+
+Model berikutnya akan dibuka lebih dulu untuk pengguna Premium.
+
+---
+
+## Batas jujur
+
+Nusa **bukan model bahasa besar**. Ia menyusun ulang kalimat yang pernah
+dibacanya memakai n-gram dan peleburan graf kata, tanpa jaringan saraf dan
+tanpa penalaran. Kalimatnya kadang masih pincang, terutama untuk pertanyaan
+yang menuntut hafalan atau perhitungan berantai.
+
+Yang dijaga: ia tidak menyalin mentah hasil pencarian, tidak membalik makna
+kalimat, dan mengaku tidak tahu daripada mengarang.
+
+---
+
+## Lisensi
+
+MIT

permerix-0.1.0/README.md

@@ -0,0 +1,160 @@
+# Permerix
+
+Pustaka Python resmi untuk layanan **Permerix**.
+
+**Permerix** adalah nama layanannya; **Nusa** adalah nama model di dalamnya —
+hubungannya seperti Claude dengan Opus.
+
+Nusa adalah AI berbahasa Indonesia yang dibangun dari nol: mesin n-gram dan
+peleburan graf kata, tanpa jaringan saraf. Ia menyusun kalimatnya sendiri dan
+bisa mencari tahu ke internet ketika tidak tahu.
+
+**Tanpa dependensi.** `pip install permerix` tidak menarik paket lain apa pun —
+pustaka ini hanya memakai modul bawaan Python.
+
+---
+
+## Pasang
+
+```bash
+pip install permerix
+```
+
+## Pakai
+
+```python
+from permerix import Permerix
+
+klien = Permerix(kunci="prx-live-xxxx")
+
+print(klien.tanya("apa itu kalimat efektif"))
+```
+
+Alamat layanan sudah tertanam di pustaka, jadi kamu tidak perlu mengaturnya.
+
+### Jawaban lengkap
+
+```python
+balasan = klien.percakapan.kirim("apa itu pantun")
+
+print(balasan.isi)
+print(balasan.kredit)        # kredit yang terpakai
+print(balasan.sisa_kredit)   # sisa; None berarti tanpa batas
+```
+
+### Mengalir
+
+```python
+for potong in klien.percakapan.alirkan("ceritakan tentang pantun"):
+    print(potong.isi, end="", flush=True)
+```
+
+### Cek kredit dan model
+
+```python
+klien.kredit()   # {'kredit': 98, 'peran': 'user', 'pesan': 2, ...}
+klien.model()    # [{'id': 'nusa-0.2', 'nama': 'Nusa 0.2', ...}]
+```
+
+---
+
+## Dari baris perintah
+
+```bash
+export PERMERIX_API_KEY=prx-live-xxxx
+
+permerix "apa itu kalimat efektif"
+permerix --alir "ceritakan tentang pantun"
+permerix --kredit
+permerix --daftar-model
+```
+
+Atau tanpa memasang perintahnya: `python -m permerix "halo"`
+
+---
+
+## Mengambil kunci
+
+Kunci API diambil lewat **bot Telegram** Permerix:
+
+1. Buka botnya, tekan `/start`
+2. Tekan tombol **Key** → **Buat Kunci**
+3. Salin kunci `prx-live-...`
+
+Pengguna baru mendapat **100 kredit gratis**. Satu pesan biasanya 1 kredit,
+naik sampai 5 bila Nusa perlu mencari ke internet.
+
+---
+
+## Pengaturan
+
+| Peubah lingkungan | Guna |
+|---|---|
+| `PERMERIX_API_KEY` | kunci API, supaya tidak perlu ditulis di kode |
+| `PERMERIX_API_URL` | alamat layanan; menimpa alamat bawaan pustaka |
+
+```python
+# Semua pengaturan bisa juga diberikan langsung
+klien = Permerix(
+    kunci="prx-live-xxxx",
+    alamat="https://api.contoh.com",   # opsional
+    tenggang=180,                       # detik
+    coba_ulang=2,                       # ulangi bila jaringan gagal
+)
+```
+
+---
+
+## Menangani kesalahan
+
+```python
+from permerix import Permerix, KreditHabis, TerlaluCepat, GalatPermerix
+
+try:
+    print(klien.tanya("halo"))
+except KreditHabis:
+    print("Kredit habis, isi ulang lewat bot Telegram.")
+except TerlaluCepat as e:
+    print(f"Terlalu cepat, tunggu sebentar. {e.pesan}")
+except GalatPermerix as e:
+    print(f"Gagal ({e.kode}): {e.pesan}")
+```
+
+Semua kesalahan turunan `GalatPermerix`, jadi satu blok `except` sudah cukup.
+
+| Kesalahan | Kapan |
+|---|---|
+| `GalatKunci` | kunci salah, tidak ada, atau sudah dicabut |
+| `KreditHabis` | kredit sudah nol |
+| `TerlaluCepat` | melewati batas laju |
+| `ModelDitolak` | model belum dirilis atau perlu peran lebih tinggi |
+| `GalatJaringan` | server tidak bisa dihubungi |
+| `GalatLayanan` | server bermasalah di sisinya |
+
+---
+
+## Model
+
+| Model | Keterangan |
+|---|---|
+| `nusa-0.2` | model bawaan, sudah dirilis |
+
+Model berikutnya akan dibuka lebih dulu untuk pengguna Premium.
+
+---
+
+## Batas jujur
+
+Nusa **bukan model bahasa besar**. Ia menyusun ulang kalimat yang pernah
+dibacanya memakai n-gram dan peleburan graf kata, tanpa jaringan saraf dan
+tanpa penalaran. Kalimatnya kadang masih pincang, terutama untuk pertanyaan
+yang menuntut hafalan atau perhitungan berantai.
+
+Yang dijaga: ia tidak menyalin mentah hasil pencarian, tidak membalik makna
+kalimat, dan mengaku tidak tahu daripada mengarang.
+
+---
+
+## Lisensi
+
+MIT

permerix-0.1.0/permerix/__init__.py

@@ -0,0 +1,48 @@
+"""
+Permerix - pustaka Python resmi.
+
+Permerix adalah nama layanannya; Nusa adalah nama model di dalamnya -
+hubungannya seperti Claude dengan Opus.
+
+    from permerix import Permerix
+
+    klien = Permerix(kunci="prx-live-xxxx")
+    print(klien.tanya("apa itu kalimat efektif"))
+
+Mengalir:
+
+    for potong in klien.percakapan.alirkan("halo"):
+        print(potong.isi, end="", flush=True)
+
+Tanpa dependensi apa pun - hanya pustaka bawaan Python.
+"""
+
+from ._versi import __version__
+from .galat import (
+    GalatJaringan,
+    GalatKunci,
+    GalatLayanan,
+    GalatPermerix,
+    KreditHabis,
+    ModelDitolak,
+    TerlaluCepat,
+)
+from .jenis import Balasan, Pemakaian, Potong
+from .klien import ALAMAT_RESMI, MODEL_BAWAAN, Permerix
+
+__all__ = [
+    "Permerix",
+    "Balasan",
+    "Potong",
+    "Pemakaian",
+    "GalatPermerix",
+    "GalatKunci",
+    "KreditHabis",
+    "TerlaluCepat",
+    "ModelDitolak",
+    "GalatJaringan",
+    "GalatLayanan",
+    "ALAMAT_RESMI",
+    "MODEL_BAWAAN",
+    "__version__",
+]

permerix-0.1.0/permerix/__main__.py

@@ -0,0 +1,92 @@
+"""
+Antarmuka baris perintah: python -m permerix
+
+    python -m permerix "apa itu kalimat efektif"
+    python -m permerix --alir "ceritakan tentang pantun"
+    python -m permerix --kredit
+    python -m permerix --model
+
+Kunci diambil dari PERMERIX_API_KEY, atau lewat --kunci.
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from ._versi import __version__
+from .galat import GalatPermerix, KreditHabis, TerlaluCepat
+from .klien import MODEL_BAWAAN, Permerix
+
+
+def main(argv: list[str] | None = None) -> int:
+    urai = argparse.ArgumentParser(
+        prog="permerix",
+        description="Berbicara dengan Permerix dari baris perintah.")
+    urai.add_argument("pesan", nargs="*", help="pesan yang ingin dikirim")
+    urai.add_argument("--kunci", help="kunci API (bawaan: PERMERIX_API_KEY)")
+    urai.add_argument("--alamat", help="alamat layanan (bawaan: bawaan pustaka)")
+    urai.add_argument("--model", dest="model_dipakai", default=MODEL_BAWAAN,
+                      help=f"model yang dipakai (bawaan: {MODEL_BAWAAN})")
+    urai.add_argument("--alir", action="store_true",
+                      help="tampilkan jawaban sepotong demi sepotong")
+    urai.add_argument("--kredit", action="store_true",
+                      help="tampilkan sisa kredit lalu keluar")
+    urai.add_argument("--daftar-model", action="store_true",
+                      help="tampilkan model yang tersedia lalu keluar")
+    urai.add_argument("--versi", action="version",
+                      version=f"permerix {__version__}")
+    pilihan = urai.parse_args(argv)
+
+    try:
+        klien = Permerix(kunci=pilihan.kunci, alamat=pilihan.alamat)
+
+        if pilihan.kredit:
+            data = klien.kredit()
+            sisa = "tanpa batas" if data.get("tanpa_batas") else data.get("kredit")
+            print(f"Peran   : {data.get('peran')}")
+            print(f"Kredit  : {sisa}")
+            print(f"Pesan   : {data.get('pesan')}")
+            return 0
+
+        if pilihan.daftar_model:
+            for m in klien.model():
+                print(f"{m['id']:<12} {m.get('nama', '')}  [{m.get('status', '')}]")
+            return 0
+
+        pesan = " ".join(pilihan.pesan).strip()
+        if not pesan:
+            urai.print_help()
+            return 2
+
+        if pilihan.alir:
+            for potong in klien.percakapan.alirkan(pesan, model=pilihan.model_dipakai):
+                if potong.selesai:
+                    print()
+                    if potong.pemakaian:
+                        print(f"[{potong.pemakaian}]", file=sys.stderr)
+                else:
+                    print(potong.isi, end="", flush=True)
+            return 0
+
+        balasan = klien.percakapan.kirim(pesan, model=pilihan.model_dipakai)
+        print(balasan.isi)
+        print(f"[{balasan.pemakaian}]", file=sys.stderr)
+        return 0
+
+    except KreditHabis as e:
+        print(f"Kredit habis: {e.pesan}", file=sys.stderr)
+        return 3
+    except TerlaluCepat as e:
+        print(f"Terlalu cepat: {e.pesan}", file=sys.stderr)
+        return 4
+    except GalatPermerix as e:
+        print(f"Gagal: {e}", file=sys.stderr)
+        return 1
+    except KeyboardInterrupt:
+        print(file=sys.stderr)
+        return 130
+
+
+if __name__ == "__main__":
+    sys.exit(main())

permerix-0.1.0/permerix/_versi.py

@@ -0,0 +1,3 @@
+"""Versi paket. Satu-satunya tempat nomor versi ditulis."""
+
+__version__ = "0.1.0"

permerix-0.1.0/permerix/galat.py

@@ -0,0 +1,68 @@
+"""
+Kesalahan yang bisa dilempar pustaka Permerix.
+
+Semuanya turunan GalatPermerix, jadi satu blok `except GalatPermerix`
+sudah cukup untuk menangkap apa pun. Yang ingin membedakan penyebabnya
+bisa menangkap turunan yang lebih khusus.
+"""
+
+from __future__ import annotations
+
+
+class GalatPermerix(Exception):
+    """Induk semua kesalahan Permerix."""
+
+    def __init__(self, pesan: str, kode: int = 0, jenis: str = "") -> None:
+        super().__init__(pesan)
+        self.pesan = pesan
+        self.kode = kode          # status HTTP, 0 bila belum sampai server
+        self.jenis = jenis        # penanda dari server, mis. "galat_kunci"
+
+    def __str__(self) -> str:
+        return f"[{self.kode}] {self.pesan}" if self.kode else self.pesan
+
+
+class GalatKunci(GalatPermerix):
+    """Kunci API tidak ada, salah, atau sudah dicabut. (401/403)"""
+
+
+class KreditHabis(GalatPermerix):
+    """Kredit pengguna sudah nol. Isi ulang lewat bot Telegram. (402)"""
+
+
+class TerlaluCepat(GalatPermerix):
+    """Melewati batas laju. Tunggu sebentar lalu coba lagi. (429)"""
+
+    def __init__(self, pesan: str, kode: int = 429, jenis: str = "",
+                 tunggu: int = 0) -> None:
+        super().__init__(pesan, kode, jenis)
+        self.tunggu = tunggu      # perkiraan detik sebelum boleh mencoba lagi
+
+
+class ModelDitolak(GalatPermerix):
+    """Model tidak dikenal, belum dirilis, atau perlu peran lebih tinggi. (403)"""
+
+
+class GalatJaringan(GalatPermerix):
+    """Server tidak bisa dihubungi sama sekali."""
+
+
+class GalatLayanan(GalatPermerix):
+    """Server menjawab dengan kesalahan di sisinya. (5xx)"""
+
+
+def dari_tanggapan(kode: int, pesan: str, jenis: str = "") -> GalatPermerix:
+    """Pilih jenis kesalahan yang paling tepat dari status HTTP."""
+    if kode == 402:
+        return KreditHabis(pesan, kode, jenis)
+    if kode == 429:
+        return TerlaluCepat(pesan, kode, jenis)
+    if kode in (401,) or jenis == "galat_kunci":
+        return GalatKunci(pesan, kode, jenis)
+    if kode == 403:
+        # 403 bisa berarti kunci admin dicabut ATAU model tidak boleh dipakai.
+        return (ModelDitolak(pesan, kode, jenis) if jenis == "model_ditolak"
+                else GalatKunci(pesan, kode, jenis))
+    if kode >= 500:
+        return GalatLayanan(pesan, kode, jenis)
+    return GalatPermerix(pesan, kode, jenis)

permerix-0.1.0/permerix/jenis.py

@@ -0,0 +1,93 @@
+"""Bentuk data yang dikembalikan pustaka: Balasan, Potong, Pemakaian."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any, Optional
+
+
+@dataclass
+class Pemakaian:
+    """Berapa kredit yang terpakai untuk satu permintaan."""
+
+    kredit: int = 0
+    rincian: str = ""
+    sisa_kredit: Optional[int] = None      # None berarti tanpa batas (owner)
+
+    @property
+    def tanpa_batas(self) -> bool:
+        return self.sisa_kredit is None
+
+    @classmethod
+    def dari(cls, data: dict[str, Any] | None) -> "Pemakaian":
+        data = data or {}
+        return cls(
+            kredit=int(data.get("kredit") or 0),
+            rincian=str(data.get("rincian") or ""),
+            sisa_kredit=data.get("sisa_kredit"),
+        )
+
+    def __str__(self) -> str:
+        sisa = "tanpa batas" if self.tanpa_batas else str(self.sisa_kredit)
+        return f"{self.kredit} kredit (sisa {sisa})"
+
+
+@dataclass
+class Balasan:
+    """Jawaban utuh dari satu percakapan."""
+
+    isi: str = ""
+    model: str = ""
+    bertanya_balik: bool = False
+    pemakaian: Pemakaian = field(default_factory=Pemakaian)
+    mentah: dict[str, Any] = field(default_factory=dict)
+
+    @classmethod
+    def dari(cls, data: dict[str, Any]) -> "Balasan":
+        # Terima dua bentuk: gaya Permerix dan gaya serupa OpenAI, supaya
+        # pustaka ini tetap bekerja bila pemanggil memakai jalur /completions.
+        balasan = data.get("balasan")
+        if isinstance(balasan, dict):
+            isi = str(balasan.get("isi") or "")
+        else:
+            pilihan = (data.get("choices") or [{}])[0]
+            isi = str((pilihan.get("message") or {}).get("content") or "")
+
+        return cls(
+            isi=isi,
+            model=str(data.get("model") or ""),
+            bertanya_balik=bool(data.get("bertanya_balik")),
+            pemakaian=Pemakaian.dari(data.get("pemakaian") or data.get("usage")),
+            mentah=data,
+        )
+
+    @property
+    def kredit(self) -> int:
+        return self.pemakaian.kredit
+
+    @property
+    def sisa_kredit(self) -> Optional[int]:
+        return self.pemakaian.sisa_kredit
+
+    def __str__(self) -> str:
+        return self.isi
+
+    def __repr__(self) -> str:
+        cuplik = self.isi[:48] + ("..." if len(self.isi) > 48 else "")
+        return f"<Balasan {self.pemakaian}: {cuplik!r}>"
+
+
+@dataclass
+class Potong:
+    """Satu kepingan jawaban saat memakai alir=True."""
+
+    isi: str = ""
+    selesai: bool = False
+    pemakaian: Optional[Pemakaian] = None
+
+    def __str__(self) -> str:
+        return self.isi
+
+    def __bool__(self) -> bool:
+        # Supaya `if potong:` berarti "ada isinya", bukan sekadar "objek ada".
+        return bool(self.isi)

permerix-0.1.0/permerix/klien.py

@@ -0,0 +1,223 @@
+"""
+Klien Permerix.
+
+    from permerix import Permerix
+
+    klien = Permerix(kunci="prx-live-xxxx")
+    print(klien.percakapan.kirim("apa itu kalimat efektif").isi)
+
+Hanya memakai pustaka bawaan Python - tidak ada dependensi sama sekali,
+jadi `pip install permerix` tidak menarik paket lain apa pun.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import time
+import urllib.error
+import urllib.request
+from typing import Any, Iterator, Optional, Sequence, Union
+
+from ._versi import __version__
+from .galat import GalatJaringan, GalatPermerix, dari_tanggapan
+from .jenis import Balasan, Pemakaian, Potong
+
+# ===========================================================================
+#  ALAMAT LAYANAN
+#
+#  Nilai di bawah ini yang dipakai bila pemanggil tidak menyebutkan alamat.
+#  Beginilah pustaka seperti Groq bekerja: alamatnya tertanam di pustaka,
+#  sehingga pemakainya cukup menulis Permerix(kunci="...").
+#
+#  SEBELUM MENERBITKAN KE PyPI, ganti dengan alamat layananmu yang sebenarnya
+#  (sebaiknya domain ber-HTTPS, bukan IP mentah).
+# ===========================================================================
+ALAMAT_RESMI = "http://localhost:8080"
+
+MODEL_BAWAAN = "nusa-0.2"
+TENGGANG_BAWAAN = 180.0
+COBA_ULANG = 2          # berapa kali mencoba lagi bila jaringan gagal
+
+
+def _alamat_bawaan() -> str:
+    """
+    Alamat yang dipakai bila tidak disebutkan.
+
+    Dibaca saat klien DIBUAT, bukan saat modul diimpor: kalau dibaca sekali di
+    awal, PERMERIX_API_URL yang dipasang belakangan - misalnya oleh skrip yang
+    memuat .env sesudah import - tidak akan pernah terpakai.
+    """
+    return os.environ.get("PERMERIX_API_URL") or ALAMAT_RESMI
+
+
+Pesan = Union[str, Sequence[dict]]
+
+
+def _bakukan_pesan(pesan: Pesan) -> list[dict]:
+    """Terima string biasa maupun daftar pesan bergaya percakapan."""
+    if isinstance(pesan, str):
+        return [{"peran": "pengguna", "isi": pesan}]
+    if isinstance(pesan, dict):
+        return [pesan]
+    return list(pesan)
+
+
+class _Percakapan:
+    """Bagian percakapan dari klien: klien.percakapan.kirim(...)."""
+
+    def __init__(self, klien: "Permerix") -> None:
+        self._klien = klien
+
+    def kirim(self, pesan: Pesan, model: str = MODEL_BAWAAN,
+              **tambahan: Any) -> Balasan:
+        """Kirim percakapan lalu tunggu jawaban utuh."""
+        badan = {"model": model, "pesan": _bakukan_pesan(pesan), "alir": False}
+        badan.update(tambahan)
+        return Balasan.dari(self._klien._minta("POST", "/v1/chat", badan))
+
+    def alirkan(self, pesan: Pesan, model: str = MODEL_BAWAAN,
+                **tambahan: Any) -> Iterator[Potong]:
+        """Kirim percakapan lalu terima jawaban sepotong demi sepotong."""
+        badan = {"model": model, "pesan": _bakukan_pesan(pesan), "alir": True}
+        badan.update(tambahan)
+        return self._klien._alir("/v1/chat", badan)
+
+
+class Permerix:
+    """
+    Klien layanan Permerix.
+
+    kunci   : kunci API dari bot Telegram. Bila kosong, diambil dari peubah
+              lingkungan PERMERIX_API_KEY.
+    alamat  : alamat layanan. Bila kosong, memakai PERMERIX_API_URL atau
+              alamat yang tertanam di pustaka.
+    tenggang: batas waktu menunggu jawaban, dalam detik.
+    """
+
+    def __init__(self, kunci: Optional[str] = None,
+                 alamat: Optional[str] = None,
+                 tenggang: float = TENGGANG_BAWAAN,
+                 coba_ulang: int = COBA_ULANG) -> None:
+        self.kunci = (kunci or os.environ.get("PERMERIX_API_KEY") or "").strip()
+        if not self.kunci:
+            raise GalatPermerix(
+                "kunci API belum diisi. Ambil lewat bot Telegram, lalu "
+                "berikan dengan Permerix(kunci=\"prx-live-...\") atau pasang "
+                "peubah lingkungan PERMERIX_API_KEY.")
+
+        self.alamat = (alamat or _alamat_bawaan()).rstrip("/")
+        self.tenggang = tenggang
+        self.coba_ulang = max(0, int(coba_ulang))
+        self.percakapan = _Percakapan(self)
+
+    # ------------------------------------------------------------- jaringan
+    def _permintaan(self, metode: str, jalur: str,
+                    badan: Optional[dict] = None) -> urllib.request.Request:
+        data = json.dumps(badan).encode("utf-8") if badan is not None else None
+        return urllib.request.Request(
+            self.alamat + jalur, data=data, method=metode,
+            headers={
+                "Authorization": f"Bearer {self.kunci}",
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+                "User-Agent": f"permerix-python/{__version__}",
+            })
+
+    def _buka(self, metode: str, jalur: str, badan: Optional[dict] = None):
+        """Buka sambungan, ubah kegagalan HTTP jadi kesalahan yang jelas."""
+        galat_akhir: Optional[Exception] = None
+
+        for percobaan in range(self.coba_ulang + 1):
+            try:
+                return urllib.request.urlopen(
+                    self._permintaan(metode, jalur, badan), timeout=self.tenggang)
+
+            except urllib.error.HTTPError as e:
+                pesan, jenis = f"HTTP {e.code}", ""
+                try:
+                    isi = json.loads(e.read().decode("utf-8"))
+                    keterangan = isi.get("galat") or {}
+                    pesan = keterangan.get("pesan", pesan)
+                    jenis = keterangan.get("jenis", "")
+                except Exception:
+                    pass
+                # Kesalahan HTTP tidak diulang: server sudah menjawab dengan
+                # tegas, mengulanginya hanya membuang kredit dan waktu.
+                raise dari_tanggapan(e.code, pesan, jenis) from None
+
+            except urllib.error.URLError as e:
+                galat_akhir = e
+            except (TimeoutError, OSError) as e:
+                galat_akhir = e
+
+            # Hanya kegagalan jaringan yang diulang, dengan jeda menaik.
+            if percobaan < self.coba_ulang:
+                time.sleep(0.5 * (percobaan + 1))
+
+        alasan = getattr(galat_akhir, "reason", galat_akhir)
+        raise GalatJaringan(
+            f"tidak bisa menghubungi {self.alamat}: {alasan}") from None
+
+    def _minta(self, metode: str, jalur: str,
+               badan: Optional[dict] = None) -> dict:
+        with self._buka(metode, jalur, badan) as tanggapan:
+            teks = tanggapan.read().decode("utf-8")
+        try:
+            return json.loads(teks)
+        except json.JSONDecodeError:
+            raise GalatPermerix(
+                f"tanggapan tidak terbaca: {teks[:120]}") from None
+
+    def _alir(self, jalur: str, badan: dict) -> Iterator[Potong]:
+        # Aliran tidak diulang: sebagian jawaban mungkin sudah terkirim, dan
+        # mengulangnya akan menghasilkan jawaban ganda.
+        klien_alir = Permerix.__new__(Permerix)
+        klien_alir.__dict__.update(self.__dict__)
+        klien_alir.coba_ulang = 0
+
+        with klien_alir._buka("POST", jalur, badan) as tanggapan:
+            for baris_bita in tanggapan:
+                baris = baris_bita.decode("utf-8").strip()
+                if not baris.startswith("data:"):
+                    continue
+                muatan = baris[5:].strip()
+                if muatan == "[DONE]":
+                    return
+                try:
+                    data = json.loads(muatan)
+                except json.JSONDecodeError:
+                    continue
+
+                if data.get("selesai"):
+                    yield Potong(selesai=True,
+                                 pemakaian=Pemakaian.dari(data.get("pemakaian")))
+                    return
+                # Dua bentuk: gaya Permerix dan gaya serupa OpenAI.
+                isi = (data.get("potong") or {}).get("isi")
+                if isi is None:
+                    pilihan = (data.get("choices") or [{}])[0]
+                    isi = (pilihan.get("delta") or {}).get("content")
+                if isi:
+                    yield Potong(isi=isi)
+
+    # --------------------------------------------------------------- guna
+    def model(self) -> list[dict]:
+        """Daftar model yang boleh dipakai kunci ini."""
+        return self._minta("GET", "/v1/model").get("data", [])
+
+    def kredit(self) -> dict:
+        """Sisa kredit dan ringkasan pemakaian."""
+        return self._minta("GET", "/v1/kredit")
+
+    def sehat(self) -> dict:
+        """Keadaan layanan. Tidak memerlukan kunci yang sah."""
+        return self._minta("GET", "/sehat")
+
+    # ------------------------------------------------------------- ringkas
+    def tanya(self, pesan: Pesan, model: str = MODEL_BAWAAN, **tambahan) -> str:
+        """Jalan pintas: kirim satu pesan, kembalikan teks jawabannya saja."""
+        return self.percakapan.kirim(pesan, model=model, **tambahan).isi
+
+    def __repr__(self) -> str:
+        return f"<Permerix {self.alamat} kunci=...{self.kunci[-6:]}>"

permerix-0.1.0/permerix.egg-info/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: permerix
+Version: 0.1.0
+Summary: Pustaka Python resmi untuk layanan Permerix (model Nusa).
+Author: Daffa Farid
+License: MIT
+Project-URL: Homepage, https://github.com/Daffa7382466/permerix
+Project-URL: Repository, https://github.com/Daffa7382466/permerix
+Project-URL: Issues, https://github.com/Daffa7382466/permerix/issues
+Keywords: permerix,nusa,ai,bahasa-indonesia,nlp,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Indonesian
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Permerix
+
+Pustaka Python resmi untuk layanan **Permerix**.
+
+**Permerix** adalah nama layanannya; **Nusa** adalah nama model di dalamnya —
+hubungannya seperti Claude dengan Opus.
+
+Nusa adalah AI berbahasa Indonesia yang dibangun dari nol: mesin n-gram dan
+peleburan graf kata, tanpa jaringan saraf. Ia menyusun kalimatnya sendiri dan
+bisa mencari tahu ke internet ketika tidak tahu.
+
+**Tanpa dependensi.** `pip install permerix` tidak menarik paket lain apa pun —
+pustaka ini hanya memakai modul bawaan Python.
+
+---
+
+## Pasang
+
+```bash
+pip install permerix
+```
+
+## Pakai
+
+```python
+from permerix import Permerix
+
+klien = Permerix(kunci="prx-live-xxxx")
+
+print(klien.tanya("apa itu kalimat efektif"))
+```
+
+Alamat layanan sudah tertanam di pustaka, jadi kamu tidak perlu mengaturnya.
+
+### Jawaban lengkap
+
+```python
+balasan = klien.percakapan.kirim("apa itu pantun")
+
+print(balasan.isi)
+print(balasan.kredit)        # kredit yang terpakai
+print(balasan.sisa_kredit)   # sisa; None berarti tanpa batas
+```
+
+### Mengalir
+
+```python
+for potong in klien.percakapan.alirkan("ceritakan tentang pantun"):
+    print(potong.isi, end="", flush=True)
+```
+
+### Cek kredit dan model
+
+```python
+klien.kredit()   # {'kredit': 98, 'peran': 'user', 'pesan': 2, ...}
+klien.model()    # [{'id': 'nusa-0.2', 'nama': 'Nusa 0.2', ...}]
+```
+
+---
+
+## Dari baris perintah
+
+```bash
+export PERMERIX_API_KEY=prx-live-xxxx
+
+permerix "apa itu kalimat efektif"
+permerix --alir "ceritakan tentang pantun"
+permerix --kredit
+permerix --daftar-model
+```
+
+Atau tanpa memasang perintahnya: `python -m permerix "halo"`
+
+---
+
+## Mengambil kunci
+
+Kunci API diambil lewat **bot Telegram** Permerix:
+
+1. Buka botnya, tekan `/start`
+2. Tekan tombol **Key** → **Buat Kunci**
+3. Salin kunci `prx-live-...`
+
+Pengguna baru mendapat **100 kredit gratis**. Satu pesan biasanya 1 kredit,
+naik sampai 5 bila Nusa perlu mencari ke internet.
+
+---
+
+## Pengaturan
+
+| Peubah lingkungan | Guna |
+|---|---|
+| `PERMERIX_API_KEY` | kunci API, supaya tidak perlu ditulis di kode |
+| `PERMERIX_API_URL` | alamat layanan; menimpa alamat bawaan pustaka |
+
+```python
+# Semua pengaturan bisa juga diberikan langsung
+klien = Permerix(
+    kunci="prx-live-xxxx",
+    alamat="https://api.contoh.com",   # opsional
+    tenggang=180,                       # detik
+    coba_ulang=2,                       # ulangi bila jaringan gagal
+)
+```
+
+---
+
+## Menangani kesalahan
+
+```python
+from permerix import Permerix, KreditHabis, TerlaluCepat, GalatPermerix
+
+try:
+    print(klien.tanya("halo"))
+except KreditHabis:
+    print("Kredit habis, isi ulang lewat bot Telegram.")
+except TerlaluCepat as e:
+    print(f"Terlalu cepat, tunggu sebentar. {e.pesan}")
+except GalatPermerix as e:
+    print(f"Gagal ({e.kode}): {e.pesan}")
+```
+
+Semua kesalahan turunan `GalatPermerix`, jadi satu blok `except` sudah cukup.
+
+| Kesalahan | Kapan |
+|---|---|
+| `GalatKunci` | kunci salah, tidak ada, atau sudah dicabut |
+| `KreditHabis` | kredit sudah nol |
+| `TerlaluCepat` | melewati batas laju |
+| `ModelDitolak` | model belum dirilis atau perlu peran lebih tinggi |
+| `GalatJaringan` | server tidak bisa dihubungi |
+| `GalatLayanan` | server bermasalah di sisinya |
+
+---
+
+## Model
+
+| Model | Keterangan |
+|---|---|
+| `nusa-0.2` | model bawaan, sudah dirilis |
+
+Model berikutnya akan dibuka lebih dulu untuk pengguna Premium.
+
+---
+
+## Batas jujur
+
+Nusa **bukan model bahasa besar**. Ia menyusun ulang kalimat yang pernah
+dibacanya memakai n-gram dan peleburan graf kata, tanpa jaringan saraf dan
+tanpa penalaran. Kalimatnya kadang masih pincang, terutama untuk pertanyaan
+yang menuntut hafalan atau perhitungan berantai.
+
+Yang dijaga: ia tidak menyalin mentah hasil pencarian, tidak membalik makna
+kalimat, dan mengaku tidak tahu daripada mengarang.
+
+---
+
+## Lisensi
+
+MIT

permerix-0.1.0/permerix.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+permerix/__init__.py
+permerix/__main__.py
+permerix/_versi.py
+permerix/galat.py
+permerix/jenis.py
+permerix/klien.py
+permerix.egg-info/PKG-INFO
+permerix.egg-info/SOURCES.txt
+permerix.egg-info/dependency_links.txt
+permerix.egg-info/entry_points.txt
+permerix.egg-info/top_level.txt

permerix-0.1.0/permerix.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

permerix-0.1.0/permerix.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+permerix = permerix.__main__:main

permerix-0.1.0/permerix.egg-info/top_level.txt

@@ -0,0 +1 @@
+permerix

permerix-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "permerix"
+dynamic = ["version"]
+description = "Pustaka Python resmi untuk layanan Permerix (model Nusa)."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Daffa Farid" }]
+keywords = ["permerix", "nusa", "ai", "bahasa-indonesia", "nlp", "sdk"]
+
+# Tanpa dependencies sama sekali: pustaka ini hanya memakai modul bawaan
+# Python. `pip install permerix` tidak akan menarik paket lain apa pun.
+dependencies = []
+
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Natural Language :: Indonesian",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/Daffa7382466/permerix"
+Repository = "https://github.com/Daffa7382466/permerix"
+Issues = "https://github.com/Daffa7382466/permerix/issues"
+
+[project.scripts]
+permerix = "permerix.__main__:main"
+
+[tool.setuptools]
+# Hanya paket "permerix" yang ikut. Ditulis tegas, bukan otomatis, supaya
+# folder lain di sekitarnya tidak pernah ikut terbawa ke paket.
+packages = ["permerix"]
+
+[tool.setuptools.dynamic]
+version = { attr = "permerix._versi.__version__" }

permerix-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+