BASKA Hub

BASKA Hub adalah package dan GitHub repository manager interaktif untuk Termux, Linux, dan Windows. BASKA menyediakan dashboard terminal, katalog publik yang tersinkron otomatis, dukungan repository private melalui baska init, serta lifecycle install/update/remove/repair/rollback.

Status: Beta / public preview. Gunakan pada perangkat Anda sendiri dan periksa detail paket sebelum menjalankan installer yang tidak Anda kenal.

Fitur utama

• Dashboard terminal interaktif: baska
• TUI curses pada terminal yang mendukungnya
• Fallback dashboard portable pada Windows/non-curses
• Katalog repository publik otomatis
• Private repository hanya ditampilkan secara lokal setelah baska init
• Install berdasarkan ID atau slug
• Platform-aware installer
• Managed recovery untuk install yang gagal
• Update, remove, repair, rollback, status, versions
• Self-update BASKA: baska upgrade
• Python, Node.js, Bash, PowerShell, Docker dan repository-only workflows
• Profiles, favorites, notifications, web catalog
• Distribusi melalui PyPI dan GitHub

Persyaratan

• Python 3.10+
• Git untuk paket berbasis repository
• Koneksi internet saat refresh/install/update
• Dependency tambahan dapat berbeda untuk setiap paket

Instalasi

Termux

pkg update
pkg install -y python git
pip install baska
baska

Jangan menjalankan python -m pip install -U pip di Termux karena pip dikelola oleh package manager Termux.

Debian / Ubuntu / UserLAnd

Direkomendasikan memakai pipx karena distro modern dapat menerapkan PEP 668:

sudo apt update
sudo apt install -y pipx python3-venv git
pipx ensurepath
pipx install baska
baska

Windows

Dengan Python 3.10+ yang sudah masuk PATH:

py -m pip install baska
baska

Jika modul curses tidak tersedia, BASKA otomatis memakai dashboard teks portable. Command langsung tetap dapat digunakan normal.

Python environment biasa

python -m pip install baska
baska

Bootstrap shell

Untuk Termux/Linux:

curl -fsSL https://raw.githubusercontent.com/baska-pro/baska-hub/main/install.sh | sh

Bootstrap sekarang memasang paket BASKA lengkap melalui pip/pipx, bukan hanya mengunduh satu launcher.

Versi terbaru langsung dari GitHub

python -m pip install -U "git+https://github.com/baska-pro/baska-hub.git"

Update BASKA

Setelah BASKA terpasang, gunakan command bawaan:

baska upgrade

Cek apakah update tersedia tanpa memasang:

baska upgrade --check

Paksa refresh/reinstall bila diperlukan:

baska upgrade --force

Alias yang setara:

baska self-update

BASKA akan memilih metode pip atau pipx sesuai instalasi yang sedang digunakan.

Dashboard

Jalankan tanpa argumen:

baska

Shortcut utama pada TUI curses:

↑ / ↓    pilih
Enter    detail
i        install
u        update
x        repair
r        remove
/        search
Esc/q    kembali
Ctrl+C   keluar

Pada Windows/non-curses, BASKA otomatis menampilkan menu portable berbasis nomor.

CLI

baska --help
baska help install
baska install --help

Perintah utama:

baska list
baska search <kata>
baska info <id|slug>
baska install <id|slug>[@tag]
baska status
baska outdated
baska update <id|slug>
baska update-all
baska upgrade
baska repair <id|slug>
baska rollback <id|slug>
baska remove <id|slug>
baska versions <id|slug>
baska refresh
baska doctor
baska init
baska logout
baska profile list
baska favorite list
baska notifications

Contoh:

baska install bersihin
baska install 49991
baska info terminal-explorer
baska repair bersihin
baska upgrade --check

Platform dan installer

BASKA tidak memaksa semua aplikasi berjalan di semua platform. Paket Windows-only tetap ditolak di Termux/Linux, dan paket Termux-only tidak dianggap otomatis kompatibel dengan Linux biasa.

Engine installer dapat menangani:

• install.sh (Bash/POSIX shell detection)
• install.ps1
• requirements*.txt
• pyproject.toml
• package.json
• Docker / Compose metadata
• single shell entrypoint
• .cmd / .bat launcher
• repository-only managed clone

Clone yang dibuat BASKA berada di:

~/.baska/packages/

Jika install sebelumnya meninggalkan managed clone dalam kondisi berubah, BASKA dapat membuat backup dan memulihkannya sebelum retry. Workspace Git pengguna di luar direktori BASKA tidak di-reset otomatis.

ID paket

• Public repository: ID numerik 5 digit
• Private repository: Pxxxxx, dibuat lokal setelah autentikasi
• Asset: Axxxxx

ID repository lama dipertahankan saat katalog diperbarui. Repository publik baru mendapat ID berikutnya.

Private repository

Metadata private tidak disimpan di katalog publik.

baska init

BASKA memverifikasi akun GitHub yang diizinkan dan menyimpan katalog private secara lokal di ~/.baska/.

Pengembangan

git clone https://github.com/baska-pro/baska-hub.git
cd baska-hub
python3 scripts/audit_catalog.py
python3 -m py_compile bin/baska baska_help.py baska_tui_v2.py baska_simple_ui.py baska_core_v2.py baska_self_update.py

Lihat CONTRIBUTING.md sebelum mengirim perubahan.

Keamanan

BASKA dapat menjalankan installer dari repository yang dipilih pengguna. Baca SECURITY.md untuk model keamanan dan pelaporan kerentanan.

Lisensi

MIT License. Lihat LICENSE.