v0.14.0

sleep3r/mtproto.zigv0.14.0Apr 10, 2026by sleep3r

Upgrading?

AI Summary

Fixes the broken bootstrap installer and adds standard CLI flags to the mtproto-proxy binary.

Key Highlights

  • Fixed artifact name mismatch and binary lookup in bootstrap.sh.
  • Added automatic CPU fallback from x86_64_v3 to baseline x86_64 for older processors.
  • Added `--help` and `--version` support to the mtproto-proxy binary.

New Features

  • Added `--help` and `--version` flags to mtproto-proxy.

Full Release Notes

# v0.14.0: Bootstrap & CLI Fixes

### 🇷🇺 Что нового (RU)

**Что решает этот релиз**
- Исправляет сломанный однострочный установщик `bootstrap.sh` — теперь он корректно скачивает и устанавливает бинарник на любой машине.
- Добавляет автоматический fallback с `x86_64_v3` на базовый `x86_64` при запуске на старых процессорах без поддержки AVX2.
- Добавляет поддержку `--help` и `--version` в сам бинарник `mtproto-proxy`.

**Что изменено**
- **`bootstrap.sh` — имена артефактов**: скрипт искал архивы под именем `mtbuddy-linux-*`, тогда как CI публикует их как `mtproto-proxy-linux-*`. Исправлено.
- **`bootstrap.sh` — поиск бинарника в архиве**: скрипт пытался найти файл `mtproto-proxy` внутри архива, но CI кладёт туда файл под именем артефакта (например `mtproto-proxy-linux-x86_64_v3`). Исправлено.
- **`bootstrap.sh` — fallback для старых CPU**: если скачанный `x86_64_v3` бинарник не запускается (illegal instruction), скрипт автоматически скачивает и устанавливает базовый `x86_64` вариант.
- **`mtproto-proxy --help / --version`**: до этого релиза любой флаг воспринимался как путь к конфигу и падал с ошибкой `Failed to load config '--help': error.FileNotFound`. Теперь флаги обрабатываются корректно.

### 🇬🇧 Release notes (EN)

**What this release addresses**
- Fixes the broken one-liner bootstrap installer — it now correctly downloads and installs the binary on any machine.
- Adds automatic CPU-level fallback from `x86_64_v3` to baseline `x86_64` on machines without AVX2 support.
- Adds proper `--help` and `--version` support to the `mtproto-proxy` binary itself.

**What changed**
- **`bootstrap.sh` — artifact names**: the script was looking for `mtbuddy-linux-*` archives while CI publishes them as `mtproto-proxy-linux-*`. Fixed.
- **`bootstrap.sh` — binary lookup inside archive**: the script searched for a file named `mtproto-proxy` inside the archive, but CI stores it under the full artifact name (e.g. `mtproto-proxy-linux-x86_64_v3`). Fixed.
- **`bootstrap.sh` — old CPU fallback**: if the downloaded `x86_64_v3` binary fails to run (illegal instruction), the script now automatically downloads and installs the baseline `x86_64` build instead.
- **`mtproto-proxy --help / --version`**: previously any flag was treated as a config path, resulting in `Failed to load config '--help': error.FileNotFound`. Flags are now handled correctly.

**Important**
- No `config.toml` changes required.
- Existing installations are unaffected — fixes only apply to the install flow.

---

### Features

* **proxy:** add --help and --version flags to mtproto-proxy ([#127](https://github.com/sleep3r/mtproto.zig/issues/127)) ([3026c42](https://github.com/sleep3r/mtproto.zig/commit/3026c428b340f5c15fc849b60eeb4e2dea31aff4))

### Bug Fixes

* **bootstrap:** align artifact names with CI output ([#124](https://github.com/sleep3r/mtproto.zig/issues/124)) ([d8ccf51](https://github.com/sleep3r/mtproto.zig/commit/d8ccf5144b6a311519665ef2a1debcc3e9b37f28))
* **bootstrap:** look up binary by artifact name inside archive ([#126](https://github.com/sleep3r/mtproto.zig/issues/126)) ([b271a5b](https://github.com/sleep3r/mtproto.zig/commit/b271a5b047e879186147ca672d15af9511b5cac9))

Related Repositories