Завантаження

Релізи до 0.9.0 називали свої архіви Chrysalis-<version>-<system>. Внутрішні назви лишаються (команда chrysalis, CHRYSALIS_*, теки з даними), щоб наявні встановлення не зламалися.

Перший запуск

1. Завантажте файл для своєї системи з таблиці вище.
2. Запустіть його. У браузері відкриється сторінка одноразового налаштування; створіть там обліковий запис (він локальний, він не покидає вашого комп'ютера).
3. Додайте модель у Налаштування > Підключення API.
4. Вітальний екран пропонує Roleplay: встановіть його одним кліком. Або відкрийте Мольфара й попросіть його про щось.

Windows із вихідного коду одним файлом

У Windows можна також запускати з вихідного коду одним файлом: покладіть Molfar-Vertep.bat (він у корені репозиторію) у будь-яку теку й двічі клацніть його. Він встановлює Git і Bun, якщо їх немає, завантажує Molfar Vertep поруч із собою, пропонує кожен новий реліз перед встановленням, збирає те, що змінилося, пропонує ярлик на робочому столі й відкриває Molfar Vertep у браузері. Molfar-Vertep.bat dev замість релізів іде за найновішою роботою в розробці. Назви тек із пробілами чи будь-якою мовою не проблема.

Якщо Git скаржиться на dubious ownership теки (її власник — інший користувач Windows: так буває на другому диску, USB-флешці або в теці, створеній від імені адміністратора), запускач зупиняється й пропонує довіряти саме цій теці. Щоб зробити це самостійно, виконайте git config --global --add safe.directory "D:/path/to/Molfar-Vertep" зі шляхом до вашої теки (з прямими скісними рисками), а потім запустіть запускач знову.

macOS

Запускайте через start.command, а не chrysalis. Ці збірки не мають підпису, який приймає macOS, тому відкриття chrysalis напряму блокується або одразу закривається з повідомленням killed. start.command знімає позначку завантаження, підписує програму для цього Mac і запускає її; користуйтеся ним знову після кожного оновлення.

Android

APK для Android підписаний debug-ключем, тож не може оновити встановлену копію: спершу видаліть старий застосунок. Перед цим експортуйте резервні копії своїх застосунків, бо видалення стирає дані застосунку.

Docker

Від версії 0.3.0 робочий процес релізу публікує ghcr.io/molfarwav/molfar-vertep (теги latest і номер версії). Налаштування й дані живуть у томі /chrysalis, а контейнер слухає порт 8788.

docker run -d --name chrysalis -p 8788:8788 -v chrysalis-data:/chrysalis \
  ghcr.io/molfarwav/molfar-vertep:latest
docker logs chrysalis        # під час першого запуску тут буде посилання для налаштування

docker-compose.yml з репозиторію робить те саме; docker compose up -d --build збирає образ із вашої копії репозиторію замість того, щоб завантажувати готовий.

Запуск із вихідного коду

Вам потрібні Git і Bun 1.4 або новіший.

git clone https://github.com/MolfarWav/Molfar.Vertep
cd Molfar.Vertep
bun install
(cd client-agent && bun install)
bun run build:client
bun start

bun run dev перезапускається після кожної зміни. bun run test запускає тести, а bun run typecheck перевіряє типи в кожному проєкті.

Оновлення

• Завантажені збірки (Windows, macOS, Linux, портативні): кнопка оновлення рушія завантажує нову версію, перезапускається й перезавантажує сторінку. Вона є також у Налаштування > Сервер.
• Застосунки: кнопка «Оновлення» у верхній панелі показує позначку, коли є щось новіше. Застосунки, які ви змінили, ніколи не перезаписуються: оновлення зливає нову версію з вашими правками.
• Android: видаліть старий застосунок і встановіть новий APK.
• Docker: docker pull ghcr.io/molfarwav/molfar-vertep:latest, потім видаліть і створіть контейнер заново з тим самим томом.
• З вихідного коду: git pull && bun install && (cd client-agent && bun install) && bun run build:client, потім перезапустіть.

Molfar Vertep тримає ваші дані у власній теці, тож оновлення ніколи їх не чіпає.