README.md

---
license: gpl-3.0
---
```php
  _  ___    _  _____ 
 | |/ / |  | |/ ____|
 | ' /| |__| | (___  
 |  < |  __  |\___ \ 
 | . \| |  | |____) | LiveUSB 0.9
 | |\_\_|  |_|_____/    with
 | |                    
 | |.   ,--()      llama.cpp + Gemma 4
 | ( )-'-.------|> Reticulum Network Stack
 | |`     `--[]    Meshtastic
 | |___   _____    
 | | \ \ / / _ \   Special for
 | | |\ V /  __/   Use in case of
 |_|_| \_/ \___|   Total BlackOUT
```
Образ KHSLiveUSB собран на базе Debian 13 Trixie с xfce и ядром 6.12 под архитектуру amd64 

Расчитан для автономной работы на Ноутбуках со средними и скромными вычислительными мощностями,
 ПК и МиниПК поставляющихся без SSD/HDD,
а так же для работы в условиях частичного или полного отсутствия интернет соединения
с возможностью локального запуска легковесных моделей нейросетей 
и организации связи через Reticulum и Meshtastic

```php
### TIMELINE:
20/04/2026 Собрал образы khsliveusb_0.9 и 8GB_khsliveusb_0.3
- В оба образа добавлены инструменты для работы в сетях Meshtastic
- esptool 4.7.0 + python3-meshtastic + contact
- Добавлены документация + электрические схемы радиомодемов
- Добавлен .apk клиент Meshtastic для Android 

11/04/2026 8GB_khsliveusb_0.2 (Образ БЕЗ НЕЙРОСЕТЕЙ)
- Добавлен rBrowser
- Добавлены .apk , .pdf и другие инструменты из 16Gb образа
- Добавлена карта мира с QTH локатором 

05/04/2026 khsliveusb_0.8 в этом образе
- Модели Qwen и Medgemma заменены на одну мультимодальную Gemma 4 E2B (via unsloth)
- Добавлены прошивки Meshtastic (надо проверить прошивку offline флэшером от RNS)
- Добавлены lxmf-bot, lxmf_messageboard, ArduinoIDE, .deb пакет openssh-server_amd64
- Добавлена база идентификации сигналов с различных спутников Artemis 
- Добавлены .pdf инструкции по APRS-via-ISS, gr-sattelites SAT Freq, satNogs transponders, etc.
- Добавлены распиновки Raspberry Pi, esp8266, esp32, Arduino Nano/UNO, etc. 
- Добавлены .apk Look4sat, Compas, SSH Client

29/03/2026 khsliveusb_0.7 в этом образе
- Выпилены stable-diffusion и whisper оставлен только llama.cpp
- Добавлены avrdude, MicroAPRS, MicroModem с документацией и схемами сборки радиомодемов 
- Добавлены таблицы частот спутников
- Добавлены .apk приложения SSTV Encoder, Robot36, Serial Monitor, и SDRTouch для работы с SDR 

20/03/2026 foximage_armv7l.0.4
- Автостарт ноды при подаче питания, сразу в режиме транспорта
- Добавлены файлы в Share директорию с распиновками к LuckFox
- Добавлен всратый Web интерфейс для конфигурирования ноды (возможность изменения конфигов пока отключена)

==============================================
18/03/2026 khsliveusb_0.6 устарел, удален
- Обновлён ребилдер
- Добавлены gpredict и cutecom
- Обновлён конфиг nomadnet (добавлен Serial Interface и автостарт ноды)
- Добавлен образ foximage_armv7l для Ноды на базе LuckFox 

10/03/2026 khsliveusb8_0.1 устарел, удален
- Добавлен образ БЕЗ НЕЙРОСЕТЕЙ

9/03/2026 khsliveusb_0.5 устарела, удалена
- Заменена модель нейросети DeepSeek на Qwen3
- Добавлен web-браузер chromium 
- Обновлены прошивки различных радиомодулей для Reticulum
- Добавлена возможность прошивки модулей из web интерфейса

8/03/2026 khsliveusb_0.4 устарел, удален
- Добавлена модель нейросети Medgemma
- Добавлены конфиги сборки llama и preRunner

6/03/2026 khsliveusb_0.3 устарел, удален
- Собран первый тестовый образ
- Обкатаны различные конфигурации HW
```

![image](images/main.jpg)

# В Дополнение к дефолтной пакетной базе Debian 13 live
# В образ интегрированы следующие инструменты:

- llama.cpp + Multimodal Gemma 4 E2B (via unsloth)

# Сетевые инструменты:
- Reticulum Network Stack (rns, nomadnet, sideband, rBrowser)
- Meshtastic (esptool, python3-meshtastic, contact)
- Встроенный репозиторий с прошивками, документацией по RNS и WEB-флэшером

# Мониторинг утилизации ресурсов:
- nmon
- lm-sensors
- psensor

# APK приложения:
- Meshtastic Client
- Sideband Client
- Serial Monitor
- SSH Client
- Robot36
- SSTV Encoder
- GGMorse Encoder/Decoder
- ft8cn

# PDF документация
- Список спутников с частотами Uplink/Downlink
- QTH Locator в формате .JPG
- Схемы различных радиомодемов
  
# Прочее:
- git
- screen
- cutecom
- gpredict
- ffmpeg
- avrdude
- ArduinoIDE
- Artemis
  
# Установка:
- Скачать образ (16Gb) https://huggingface.co/cyberunit/KHSLiveUSB/resolve/main/amd64_khsliveusb_0.9.iso

 или

- Образ БЕЗ НЕЙРОСЕТЕЙ (8Gb) https://huggingface.co/cyberunit/KHSLiveUSB/resolve/main/amd64_8GB_khsliveusb_0.3.iso

 или 

- Образ для создания своей Ноды в сети Reticulum на базе микрокомпьютера LuckFox Pico Pro Max
- https://huggingface.co/cyberunit/KHSLiveUSB/resolve/main/armv7l_FoxNode_image_0.4.bin
(8Gb)
Github Repo --> https://github.com/sw3nlab/KHSLiveUSB
![image](images/foxnode.jpg)
![image](images/cyberfox.jpg)
- Записать образ на флэшку:
- - в Windows можно использовать Rufus (запись в режиме dd)
- - в Linux с помощью dd
- - `dd if=khsliveusb_0.9.iso of=/dev/sd? bs=1M status=progress`


- для оптимальной скорости работы, лучше использовать USB порты SS, 
 флэшки не менее 16Gb с хорошей скоростью чтения/записи стандарта не ниже USB 3.2

- При первой загрузке ОБРАЗА С НЕЙРОСЕТЯМИ на НОВОЙ аппаратной конфигурации,
необходимо воспользоватся ярлыком "New Build" на рабочем столе
и только после этого использовать ярлык Gemma4
для запуска web-интерфейса общения с нейросетью

# Образ протестирован на:
<b>AMD Ryzen 7 4750u (16Gb RAM)</b></br>
<b>AMD Ryzen AI 9 365 (32Gb RAM)</b></br>
<b>Intel Core i5 9300H (16Gb RAM)</b></br>
<b>Intel Core i5 9400F (8Gb RAM)</b></br>
<details>
<summary><b>Intel Core i7 5500U (8Gb RAM)</b></summary>
medgemma-4b-it-Q4_K_M (2.3Gb)
  ~5 t/s
![image](images/intel_i75500.jpg)

![image](images/intel_medgemma_i75500.jpg)
</details>


### QA и Известные ошибки:

> Скачал, записал на флэшку, работает, но грузится УЖАСНО МЕДЛЕННО

Для нормальной работы желательно использовать USB флэшку стандарта USB 3.2 
и вставлять её в порт с обозначением (SS) Super Speed

> ПК ушёл в спящий режим, теперь требует пароль

пароль `live`

> Ошибка "Illegal instruction" при запуске любой модели

решается пересборкой llama ---> ярлык "New Build"

> У меня слабый интернет канал, и долго выкачивать 16Гб образа, будет ли образ на 8Гб

Образ на 8Gb БЕЗ НЕЙРОСЕТЕЙ, только с инструментами RNS и Meshtastic
можно скачать по этой ссылке: https://huggingface.co/cyberunit/KHSLiveUSB/resolve/main/amd64_8GB_khsliveusb_0.3.iso
Возможно будут образы на базе других дистрибутивов и образ без иксов.


> Как прошить радиомодуль Heltec v2 из вашего образа
- подключить радиомодуль к любому рабочему/свободному USB порту.
- Запустить Sideband с рабочего стола
- Перейти в раздел Repository и нажать Star Repository Server
- открыть в браузере Chromium адрес https://127.0.0.1:4444/mirrors/rnode-flasher/RNode_Flasher.html
- список доступных прошивок для различных модулей находится по адресу
- https://127.0.0.1:4444/pkgs.html

> Хочу подключится к Reticulum серверу, куда нада нажать если СЕТЬ ЕСТЬ

По умолчанию в образе, в конфиге ~/.reticulum/config прописан интерфейс:
 TCPClient Interface (с дефолтным сервером)
![image](images/screenTCP.png)
Для подключения к серверу как TCPClient, необходимо в конфиге указать нужный вам адрес сервера и порт,
 а так же перевести интерфейс в активное состояние и перезапустить либо Sideband либо Nomadnet.
**конфиг можно редактировать как вручную по старинке через Mousepad/nano/vi так и через Nomadnet

> Хочу подключится к Reticulum. СЕТИ НЕТ!

По умолчанию в образе, в конфиге ~/.reticulum/config прописан интерфейс:
 Rnode LoRa Interface
![image](images/rnode.png)
Для подключения через этот интерфейс, необходимо иметь радиомодуль из списка поддерживаемых в конфиге для этого интерфейса указать частоту, ширину канала и др.
 а так же перевести интерфейс в активное состояние и перезапустить либо Sideband либо Nomadnet.

> Хочу подключится к Meshtastic. СЕТИ НЕТ!

![image](images/meshmodems.jpg)
Для работы в сетях Meshtastic
Необходимо собрать поддерживаемый радиомодем
к примеру на железяках esp wroom 32 NodeMCU + LoRa SX1278 433MHz
схемы радиомодемов можно найти в директории ~/Meshtastic/PDF
Для прошивки радиомодема образ оборудован флэшером esptool
Инструкция по прошивке лежит в ~/Meshtastic/README.md

Так же образ оборудован консольным клиентом contact, для работы на ПК:
`~/myvenv/bin/contact --port /dev/ttyUSB?`
И Клиентским приложением для работы на Android девайсе, найти который можно по адресу:
`~/Meshtastic/APK`

Выразить благодарность за сборку можно на странице пожертвований
 Donate: https://dzen.ru/cyberunit?donate=true