Metadata-Version: 2.4
Name: ninmeni
Version: 1.0.0
Summary: NINMENI — Neural Indonesian Meaning Engine for Natural Intelligence. AI framework that understands token meaning, NOT next-token prediction.
Author-email: Emylton Leunufna <emylton@leunufna.dev>
License: MIT
Project-URL: Homepage, https://github.com/Rafael2022-prog/ninmeni
Project-URL: Repository, https://github.com/Rafael2022-prog/ninmeni
Project-URL: Issues, https://github.com/Rafael2022-prog/ninmeni/issues
Keywords: nlp,indonesian,bahasa,linguistics,semantic,morphology,meaning-comprehension,bijective-decoding,non-autoregressive,kbbi,reasoning
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.13
Classifier: Natural Language :: Indonesian
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: torch>=2.0.0
Requires-Dist: numpy>=1.24.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pyyaml>=6.0; extra == "dev"
Dynamic: license-file

# NINMENI

> *"Kami tidak mengajarkan model bahasa Indonesia. Kami membuat model lahir sebagai bahasa Indonesia."*
>
> — Emylton Leunufna

---

## Apa itu NINMENI?

NINMENI terdiri dari dua hal yang berbeda namun saling terkait:

### 1. NINMENI Framework

**Framework untuk membangun model NLP yang MEMAHAMI makna, bukan memprediksi token berikutnya.**

NINMENI Framework adalah toolkit yang bisa digunakan oleh engineer manapun untuk membangun model bahasa Indonesia (atau bahasa lain) dengan prinsip pemahaman makna. Framework ini menyediakan primitif linguistik, arsitektur representasi, dan pipeline training yang secara fundamental berbeda dari paradigma Transformer/LLM.

> **Dokumentasi lengkap:** [`docs/FRAMEWORK.md`](docs/FRAMEWORK.md)

### 2. NINMENI Model (1.3B)

**Model pertama yang dihasilkan oleh NINMENI Framework.**

Model NLP 1.3 miliar parameter untuk bahasa Indonesia yang memahami makna kalimat melalui representasi bijektif, bukan statistik distribusi token. Dilatih menggunakan KBBI sebagai fondasi semantik.

> **Dokumentasi lengkap:** [`docs/MODEL.md`](docs/MODEL.md)

---

## Prinsip Fundamental

```
NINMENI BUKAN language model konvensional.

LLM  : Input → langsung prediksi output (TANPA pemahaman)
NINMENI : Input → MEMAHAMI makna → MENALAR → Output DARI pemahaman

Konsekuensi:
  ✗ Tidak ada next-token prediction
  ✗ Tidak ada cross-entropy atas distribusi token
  ✗ Tidak ada sampling stokastik
  ✓ Neural genuine — model MEMAHAMI makna, bukan sekedar mencocokkan pola
  ✓ Pemahaman dan penalaran terjadi SEBELUM output dihasilkan
  ✓ Setiap keputusan bisa dijelaskan
```

---

## Quick Start

### Framework (analisis deterministik)

```python
from ninmeni import NinmeniFramework

fw = NinmeniFramework.dari_kbbi("kbbi_core_v2.json")
state = fw.proses("Hakim menjatuhkan hukuman kepada terdakwa.")

print(state.skor_linguistik)   # 0.72
print(state.krl_result.proposisi)  # JATUH(agen=Hakim, pasien=hukuman, penerima=terdakwa)
```

### Model (pemahaman neural)

```python
from ninmeni.core.meb_v2 import MesinEvolusiBahasa_v2, MEBv2Config

config = MEBv2Config.config_1_3B()
meb = MesinEvolusiBahasa_v2(config)
# Load checkpoint, lalu gunakan untuk memahami makna kalimat
```

---

## Instalasi

```bash
# Dari PyPI
pip install ninmeni

# Dari source
git clone https://github.com/rafaelsistems/ninmeni.git
cd ninmeni
pip install -e .
```

**Requirements:** Python 3.9+, PyTorch 2.0+, NumPy 1.24+

---

## Struktur Proyek

```
ninmeni/
├── primitives/              ← Framework: 6 primitif linguistik
│   ├── lps/                    Linguistic Parse System
│   ├── sfm/                    Semantic Field Manifold
│   ├── cpe/                    Constraint Propagation Engine
│   ├── cmc/                    Categorical Meaning Composer
│   ├── tda/                    Topological Dependency Analyzer
│   └── krl/                    Knowledge Representation Layer
├── base/                    ← Framework: base classes
│   ├── state.py                NinmeniState (output pipeline)
│   └── head.py                 NinmeniHead (base class custom head)
├── framework.py             ← Framework: orkestrator utama
├── config.py                ← Framework: konfigurasi domain
│
├── core/                    ← Model: arsitektur neural
│   ├── meb_v2.py               Mesin Evolusi Bahasa v2 (1.3B)
│   ├── bsu.py                  Bahasa State Unit
│   ├── plausibility.py         PlausibilityHead (Layer 2)
│   ├── correctness.py          CorrectnessHead (Layer 1)
│   ├── semantik_kristal.py     SemantikKristal
│   ├── gos.py                  Generator Output Struktural
│   └── model.py                NinmeniModel
│
├── training/                ← Model: training utilities
├── linguistic/              ← Shared: utilitas linguistik
└── eval/                    ← Shared: evaluasi

docs/
├── FRAMEWORK.md             ← Dokumentasi framework (untuk engineer)
├── MODEL.md                 ← Dokumentasi model 1.3B (hasil training)
├── NINMENI_FRAMEWORK_SPEC.md   Spesifikasi teknis framework
└── NINMENI_PRIMITIVES_MATH.md  Fondasi matematis primitif

tools/                       ← Script training, evaluasi, dan utilitas
```

---

## Dokumentasi

| Dokumen | Untuk Siapa | Isi |
|---------|-------------|-----|
| [`docs/FRAMEWORK.md`](docs/FRAMEWORK.md) | Engineer yang ingin **membangun model** dengan NINMENI | Arsitektur primitif, cara pakai, API, cara extend |
| [`docs/MODEL.md`](docs/MODEL.md) | Peneliti yang ingin **menggunakan model** NINMENI 1.3B | Arsitektur MEB v2, training, checkpoint, evaluasi |
| [`docs/NINMENI_FRAMEWORK_SPEC.md`](docs/NINMENI_FRAMEWORK_SPEC.md) | Kontributor framework | Spesifikasi teknis mendalam |
| [`docs/NINMENI_PRIMITIVES_MATH.md`](docs/NINMENI_PRIMITIVES_MATH.md) | Peneliti | Fondasi matematis setiap primitif |

---

## Penulis

**Emylton Leunufna**

## Lisensi

MIT
