Skip to content

Commit c5d483d

Browse files
committed
docs: improve installation instructions for better user experience
- Add Method A (recommended): apt install for automatic dependency handling - Add Method B (alternative): dpkg with fallback instructions - Correct binary size from 13MB to realistic 3MB - Simplify installation process for beginners - Add clear fallback commands for dependency issues - Focus on user-friendly documentation over complex one-liners
1 parent a8e890c commit c5d483d

1 file changed

Lines changed: 25 additions & 1 deletion

File tree

.github/workflows/ci.yml

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -399,27 +399,51 @@ jobs:
399399
400400
### 🛠 Installation
401401
#### Ubuntu/Debian (DEB - Recommended)
402+
403+
##### Method A: Recommended (handles dependencies)
404+
405+
**AMD64 systems:**
406+
```bash
407+
wget https://github.com/NDXDeveloper/uubu/releases/download/${{ github.ref_name }}/uubu-${{ github.ref_name }}-amd64.deb
408+
sudo apt install ./uubu-${{ github.ref_name }}-amd64.deb
409+
uubu --version
410+
```
411+
412+
**ARM64 systems (Raspberry Pi, etc.):**
413+
```bash
414+
wget https://github.com/NDXDeveloper/uubu/releases/download/${{ github.ref_name }}/uubu-${{ github.ref_name }}-arm64.deb
415+
sudo apt install ./uubu-${{ github.ref_name }}-arm64.deb
416+
uubu --version
417+
```
418+
419+
##### Method B: Using dpkg
402420
**AMD64 systems:**
403421
```bash
404422
wget https://github.com/NDXDeveloper/uubu/releases/download/${{ github.ref_name }}/uubu-${{ github.ref_name }}-amd64.deb
405423
sudo dpkg -i uubu-${{ github.ref_name }}-amd64.deb
424+
# If you have dependency errors, run this:
425+
sudo apt-get install -f
406426
uubu --version
407427
```
408428
409429
**ARM64 systems (Raspberry Pi, etc.):**
410430
```bash
411431
wget https://github.com/NDXDeveloper/uubu/releases/download/${{ github.ref_name }}/uubu-${{ github.ref_name }}-arm64.deb
412432
sudo dpkg -i uubu-${{ github.ref_name }}-arm64.deb
433+
# If you have dependency errors, run this:
434+
sudo apt-get install -f
413435
uubu --version
414436
```
415437
416438
#### Manual installation (all architectures)
417439
```bash
418440
# Linux AMD64
441+
wget https://github.com/NDXDeveloper/uubu/releases/download/${{ github.ref_name }}/uubu-linux-amd64
419442
chmod +x uubu-linux-amd64
420443
sudo mv uubu-linux-amd64 /usr/local/bin/uubu
421444
422445
# Linux ARM64
446+
wget https://github.com/NDXDeveloper/uubu/releases/download/${{ github.ref_name }}/uubu-linux-arm64
423447
chmod +x uubu-linux-arm64
424448
sudo mv uubu-linux-arm64 /usr/local/bin/uubu
425449
```
@@ -469,7 +493,7 @@ jobs:
469493
```
470494
471495
### 🔧 Technical Details
472-
- **Binary size**: ~13MB (includes embedded locales)
496+
- **Binary size**: ~3MB (includes embedded locales)
473497
- **Dependencies**: None (static binary)
474498
- **License**: MIT
475499
- **Architectures**: AMD64, ARM64

0 commit comments

Comments
 (0)