Parara

Aplikasi paraphrase teks bahasa Indonesia yang berjalan secara lokal di komputer Anda. Antarmuka utama disajikan lewat aplikasi desktop Windows (Electron): server Express berjalan di dalam aplikasi, jadi Anda tidak perlu membuka browser secara terpisah.

Fitur inti pipeline pemrosesan:

normalisasi teks
perbaikan typo/ejaan ringan
grammar check berbasis rule sederhana
perbaikan tanda baca dan kapitalisasi
penggantian sinonim Indonesia
transformasi struktur kalimat
variasi frasa umum
penyesuaian gaya bahasa
humanization untuk hasil lebih natural

Parara open source dan gratis tanpa sistem lisensi serial.
Kredit proyek: Abdurozzaq Nurul Hadi.

Aplikasi desktop Windows (disarankan)

Prasyarat

Node.js (disarankan LTS)
Windows 10/11 (x64)

Instalasi dependensi

npm install

Menjalankan aplikasi desktop (tanpa build installer)

npm run desktop:start

Perintah di atas memakai Electron dan membuka jendela Parara. Server HTTP internal dipilih secara dinamis (biasanya 127.0.0.1 dengan port acak) sehingga tidak bentrok dengan aplikasi lain.

Membuat installer Windows (`.exe`)

npm run desktop:dist

Artefak utama ada di folder dist/:

Installer NSIS: dist/Parara-Setup-<versi>.exe (nama mengikuti version di package.json)

Icon aplikasi Windows berasal dari assets/parara.ico. Jika ingin mengubah tampilan icon, edit alur di scripts/generate-icon.js lalu jalankan:

npm run generate:icon

Setelah itu build ulang dengan npm run desktop:dist.

Portable EXE dan otomatisasi MSIX (Microsoft Store)

Portable (satu file .exe, tanpa installer NSIS):

npm run desktop:portable

Artefak: dist/Parara-portable-<versi>.exe (lihat electron-builder.portable.cjs).

Installer NSIS untuk MSIX CLI (disarankan): MSIX Packaging Tool membutuhkan installer .exe yang bisa dijalankan unattended (biasanya NSIS dengan /S). Template bawaan memakai dist/Parara-Setup-<versi>.exe + Arguments="/S". Bangun dulu dengan npm run desktop:dist:unsigned atau npm run desktop:dist.

Folder win-unpacked: hanya untuk eksperimen; untuk CLI set MSIX_PACKAGING_MODE=unpacked dan wajib MSIX_INSTALLER_ARGUMENTS (Parara.exe biasanya bukan installer sunyi—lebih mudah pakai NSIS di atas).

npm run desktop:unpack

Template + CLI MSIX Packaging Tool:

Pasang MSIX Packaging Tool dari Microsoft Store dan pastikan alias MsixPackagingTool.exe tersedia (biasanya butuh PowerShell sebagai administrator untuk create-package).
Set identitas (sesuaikan dengan Partner Center / sertifikat publisher):
- MSIX_PUBLISHER_CN — misalnya CN=Nama Anda (harus konsisten dengan akun developer).
- MSIX_PUBLISHER_DISPLAY — nama tampilan publisher.
- MSIX_PACKAGE_NAME — nama paket identitas (huruf/angka), default Parara.
Generate template + jalankan tool:

npm run desktop:msix:template
npm run desktop:msix

Atau satu rangkaian (installer NSIS unsigned → template → packaging):

npm run desktop:msix:full

Dengan signing dari .env: npm run desktop:msix:full:signed.

Berkas keluaran target: dist/msix/Parara-<versi>.msix (versi empat segmen dari package.json).

Argumen installer: opsional MSIX_INSTALLER_ARGUMENTS (default /S untuk NSIS/portable).

Mode portable ke MSIX: MSIX_PACKAGING_MODE=portable, lalu npm run desktop:portable, npm run desktop:msix:template, npm run desktop:msix.

Detail CLI: Create a package using the command line interface. Template sumber: msix/conversion-template.xml; hasil terisi: dist/msix/conversion.generated.xml.

Template / CLI: <Installer> memakai skema template/2018 + Arguments="/S" (atau nilai MSIX_INSTALLER_ARGUMENTS) agar tool tidak meminta UnattendedInstallWithoutArgument. Input default adalah Parara-Setup-*.exe, bukan Parara.exe mentah dari win-unpacked.

MSIX harus “terpercaya” (error 0x800B010A): pesan publisher certificate could not be verified artinya Windows tidak mempercayai rantai sertifikat yang menandatangani paket .msix (bukan bug Parara). Umumnya:

Sideload / coba di PC sendiri: paket harus ditandatangani dengan sertifikat code signing yang valid, atau untuk uji saja impor sertifikat publik (.cer) publisher ke Local Machine → Trusted People (Administrator), lalu pasang ulang MSIX. Sertifikat self-signed atau bukan code signing tidak dipercaya mesin lain.
Microsoft Store: setelah unggah ke Partner Center, alur Store menangani kepercayaan sesuai kebijakan Microsoft; paket lokal yang dibuat MSIX Packaging Tool sering tetap perlu publisher identity yang cocok dengan akun developer dan panduan signing Store.

Menandatangani .msix setelah dibuat (jika Anda punya .pfx code signing + Windows SDK), contoh:

signtool sign /fd SHA256 /f "C:\path\ke\codesign.pfx" /p "SANDI" /tr http://timestamp.digicert.com /td SHA256 "dist\msix\Parara-1.0.0.0.msix"

PublisherName di template (MSIX_PUBLISHER_CN, mis. CN=...) harus selaras dengan subjek sertifikat yang dipakai menandatangani MSIX. Lihat Sign an MSIX package.

Code signing (Microsoft Store Policy 10.2.9)

Untuk pengiriman ke Microsoft Store sebagai paket Win32 (installer NSIS), biner harus memiliki tanda tangan Authenticode SHA-256 dari rantai kepercayaan yang diterima. Tanpa itu, Partner Center akan menandai pelanggaran kebijakan 10.2.9.

Sertifikat: siapkan sertifikat code signing (biasanya OV/EV, algoritme SHA-256) dari CA yang diakui, atau gunakan layanan Trusted Signing di Azure sesuai panduan Microsoft. Jangan mengunggah file .pfx ke repositori; file tersebut sudah dicantumkan di .gitignore.

Build bertanda tangan (disarankan untuk rilis Store): electron-builder tidak membaca .env secara otomatis. Pilih salah satu:

npm run desktop:dist:signed — memuat .env lalu menjalankan build (pastikan di .env ada CSC_LINK dan CSC_KEY_PASSWORD tanpa spasi di sekitar =, path bisa memakai bentuk C:/...); atau
PowerShell: $env:CSC_LINK = "C:\path\ke\cert.pfx"; $env:CSC_KEY_PASSWORD = "..."; npm run desktop:dist

Variabel:

CSC_LINK — path absolut ke file .pfx, atau URL HTTPS ke arsip sertifikat (lihat dokumentasi electron-builder tentang code signing).
CSC_KEY_PASSWORD — sandi untuk .pfx (jangan commit; folder key/ di-ignore oleh git).

Penting: .pfx harus berupa sertifikat code signing (EKU Code Signing), bukan sertifikat TLS/SSL untuk website (misalnya origin certificate). Kalau Get-AuthenticodeSignature tetap NotSigned setelah env benar, biasanya berarti signtool menolak sertifikat itu untuk menandatangani .exe.

Alternatif: isi certificateFile / certificatePassword di package.json under build.win hanya jika Anda yakin tidak akan pernah commit rahasia (lebih aman tetap memakai variabel lingkungan atau secret CI).

Build lokal tanpa sertifikat: kontributor yang tidak punya sertifikat dapat memakai:

npm run desktop:dist:unsigned

Perintah ini memakai electron-builder.unsigned.cjs (menyalin build dari package.json lalu menonaktifkan penandatanganan .exe); jangan mengunggah artefak unsigned ke Store.

Verifikasi sebelum unggah: setelah build bertanda tangan, jalankan di PowerShell:

npm run desktop:verify-signature

Atau: .\scripts\verify-windows-signature.ps1 -Artifact "dist\Parara-Setup-<versi>.exe". Status harus Valid.

Trusted Signing (Azure): electron-builder mendukung azureSignOptions di build.win untuk mengalihkan penandatanganan ke Azure; rinciannya ada di dokumentasi electron-builder (Windows) dan Trusted Signing.

Jika npm run desktop:dist gagal dengan error symlink (Cannot create symbolic link saat mengekstrak cache winCodeSign): setelah npm install, skrip postinstall menyesuaikan biner app-builder.exe agar 7-Zip memakai switch -snl- (jangan pulihkan symlink) alih-alih -snld, sehingga ekstraksi winCodeSign-*.7z tidak membutuhkan hak symlink. Jika pesan itu masih muncul, jalankan node scripts/patch-app-builder-win-7z.cjs sekali lagi, hapus folder %LOCALAPPDATA%\electron-builder\Cache\winCodeSign, lalu ulangi build. Cadangan: aktifkan Mode pengembang di Windows (Pengaturan → Sistem → Untuk pengembang) atau jalankan terminal sebagai administrator.

build.toolsets.winCodeSign 1.1.0 memaketkan signtool lewat ZIP Windows terpisah (berguna saat Anda sudah punya sertifikat); itu tidak menggantikan langkah rcedit yang memicu unduhan winCodeSign di atas.

Alternatif MSIX: lihat bagian Portable EXE dan otomatisasi MSIX di atas; untuk alur manual, ikuti MSIX Packaging Tool dan aturan Partner Center.

Partner Center — “Add or remove programs” & bundleware (rekomendasi sertifikasi):

Nama aplikasi di Programs and Features: di package.json, build.nsis.uninstallDisplayName disetel ke teks yang lebih deskriptif (bukan hanya “Parara” + versi), agar pengguna mudah mengenali produk. Publisher di ARP mengikuti author.name — samakan dengan nama publisher di Partner Center jika Microsoft meminta konsistensi.
Kebijakan 10.2.2 (bundleware): Parara tidak memasang perangkat lunak pihak ketiga terpisah (tidak ada toolbar, tidak ada installer lain yang diselipkan). Isi paket = aplikasi Electron + dependensi Node yang tercantum di repo. Di Certification notes / tanggapan review, Anda bisa menulis bahwa satu-satunya entri ARP adalah Parara sendiri dan tidak ada bundling perangkat lunak tambahan yang melanggar kebijakan.

Setelah lolos verifikasi lokal: unggah ulang paket di Partner Center. Jika beralih dari Win32 ke MSIX dengan nama yang sama, ikuti petunjuk di dashboard untuk menghapus atau menyesuaikan listing yang bentrok.

macOS dan Linux

Installer resmi untuk macOS atau Linux tidak disertakan di repo ini. Anda bisa membangunnya sendiri di mesin target (disarankan menjalankan electron-builder pada OS yang sama dengan target paket):

npm install
# Contoh: hanya macOS (jalankan di macOS)
npx electron-builder --mac

# Contoh: hanya Linux (jalankan di Linux)
npx electron-builder --linux

Untuk opsi target lengkap (DMG, AppImage, deb, dan lainnya), lihat dokumentasi electron-builder.

Mode pengembangan: API + browser lokal

Jika Anda mengembangkan atau ingin mengakses Parara seperti layanan web lokal:

npm install
npm run dev

Server berjalan di http://localhost:3000 (atau port dari variabel lingkungan PORT).

Endpoint API

`POST /paraphrase`

Satu request menjalankan correction pipeline lokal terlebih dahulu, lalu meneruskan hasilnya ke engine paraphrase.

Request body:

{
  "text": "Oleh karena itu, sistem ini membantu pengguna menyelesaikan masalah dengan cepat.",
  "mode": "formal",
  "strength": 4,
  "preserve_keywords": ["pengguna"]
}

Contoh curl (mode web lokal, port default 3000):

curl -X POST http://localhost:3000/paraphrase \
  -H "Content-Type: application/json" \
  -d "{\"text\":\"Oleh karena itu, sistem ini membantu pengguna menyelesaikan masalah dengan cepat.\",\"mode\":\"formal\",\"strength\":4,\"preserve_keywords\":[\"pengguna\"]}"

Contoh respons:

{
  "original": "Oleh karena itu, sistem ini membantu pengguna menyelesaikan masalah dengan cepat.",
  "paraphrased": "Karena itu, sistem ini mendukung pengguna menyelesaikan kendala dengan segera.",
  "techniques_used": [
    "text_normalization",
    "typo_correction",
    "grammar_fix",
    "punctuation_fix",
    "synonym_replacement",
    "phrase_expression_variation",
    "style_adjustment_formal",
    "humanization"
  ],
  "similarity_score": 72.31
}

Struktur proyek

electron/          # proses utama Electron (desktop)
public/            # antarmuka web yang dilayani Express
src/               # server Express, engine paraphrase, data
assets/            # icon desktop (mis. parara.ico)
scripts/           # utilitas build, mis. generate icon
tests/

Testing

npm test

Generate data sinonim

Generator mengambil sinonim dari sumber yang sama dengan package synonym-antonym-indonesia, yaitu sinonimkata.com. Konfigurasi default dibaca dari file .env.

Siapkan daftar kata di wordlist.txt (atau file lain via env SYNONYM_WORDLIST).
Jalankan generator:

npm run generate:synonyms

Output default ditulis ke src/data/synonyms.generated.json agar tidak menimpa src/data/synonyms.json yang sudah dikurasi manual.

Env opsional:

SYNONYM_WORD_LIMIT (default: 3000, pakai all/full/0 untuk proses semua isi wordlist.txt)
SYNONYM_MAX_REPLACEMENTS (default: 8)
SYNONYM_REQUEST_DELAY_MS (default: 350)
SYNONYM_CPU_TARGET (default: 0.75, otomatis jadi jumlah worker dari logical CPU)
SYNONYM_MAX_CONCURRENCY (opsional, override langsung jumlah worker)
SYNONYM_REQUIRE_IN_WORDLIST=1 untuk memaksa sinonim harus ada di wordlist

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Parara

Aplikasi desktop Windows (disarankan)

Prasyarat

Instalasi dependensi

Menjalankan aplikasi desktop (tanpa build installer)

Membuat installer Windows (`.exe`)

Portable EXE dan otomatisasi MSIX (Microsoft Store)

Code signing (Microsoft Store Policy 10.2.9)

macOS dan Linux

Mode pengembangan: API + browser lokal

Endpoint API

`POST /paraphrase`

Struktur proyek

Testing

Generate data sinonim

About

Uh oh!

Releases 1

Packages

Uh oh!

Contributors

Uh oh!

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
assets		assets
electron		electron
msix		msix
public		public
scripts		scripts
src		src
tests		tests
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
electron-builder.portable.cjs		electron-builder.portable.cjs
electron-builder.unpack.cjs		electron-builder.unpack.cjs
electron-builder.unsigned.cjs		electron-builder.unsigned.cjs
generate-data.js		generate-data.js
nodemon.json		nodemon.json
package-lock.json		package-lock.json
package.json		package.json
pad_file.xml		pad_file.xml
synonyms.json		synonyms.json
wordlist.txt		wordlist.txt

Folders and files

Latest commit

History

Repository files navigation

Parara

Aplikasi desktop Windows (disarankan)

Prasyarat

Instalasi dependensi

Menjalankan aplikasi desktop (tanpa build installer)

Membuat installer Windows (.exe)

Portable EXE dan otomatisasi MSIX (Microsoft Store)

Code signing (Microsoft Store Policy 10.2.9)

macOS dan Linux

Mode pengembangan: API + browser lokal

Endpoint API

POST /paraphrase

Struktur proyek

Testing

Generate data sinonim

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Membuat installer Windows (`.exe`)

`POST /paraphrase`

Packages