Skip to content

Ferrum v0.7.12

Choose a tag to compare

@ominiverdi ominiverdi released this 25 Oct 08:38
· 2 commits to main since this release

Ferrum v0.7.12 adds model-requested image reads, persistent performance preferences, configurable provider timeouts, and reliable CLI overrides when resuming print sessions.

Highlights

  • Read images with the existing read tool. Ferrum recognizes PNG, JPEG, and WebP by file content and passes the actual image to supported models. Accepted images survive session resume. Readable-root restrictions, image validation, and aggregate budgets still apply; terminal and tool-status output do not expose image payloads.
  • Remember /perf on|off. Performance-summary preferences are saved in the user configuration and session metadata. Resumed sessions restore their saved preference. --perf enables summaries for the opened session without changing the global default. Timing samples are not persisted, and print-mode summaries stay on stderr.
  • Configure inference timeouts per provider. OpenAI-compatible providers accept timeout_seconds = 1..86400 for response headers, streaming idle gaps, and non-streaming body deadlines. This supports slow local model loading and prompt processing without weakening cancellation or response-size limits. Defaults are unchanged when omitted.
  • Honor explicit options on print resume. --session and --resume now respect explicit provider/model selections and the selected model's context budget, as well as explicit thinking and safety settings. Provider-bound aliases route correctly, project safety restrictions remain enforced, and runtime provider/model overrides do not rewrite saved preferences.

Example for slow local inference:

[providers.local-infer]
type = "openai-compatible"
base_url = "http://localhost:8192"
timeout_seconds = 180

Restart Ferrum after editing provider configuration.

Dependency hardening

  • Update Tokio to 1.53.3, addressing RUSTSEC-2026-0386.
  • Replace deprecated serde_yaml / unmaintained unsafe-libyaml with serde-saphyr, using only its deserializer. Skill frontmatter retains standard string/block/alias support, with explicit parsing and alias-expansion budgets. Includes and environment interpolation are disabled.
  • Update locked rustls and rustls-webpki dependencies to 0.23.46 and 0.103.16 to clear their reported advisories. These packages are not active in Ferrum's current Linux TLS path, which uses native TLS/OpenSSL.

Validation

  • 672 tests passed, including seven new skill YAML regression tests.
  • Formatting, strict Clippy, the release build, benchmark/package checks, and cargo audit --deny warnings passed without advisory exceptions.
  • Two clean compatibility-container builds produced byte-identical release assets.
  • DEB and tarball smoke tests passed on Debian 12; RPM installation and smoke tests passed on Fedora 43.
  • The packaged binary passed model-context-limit and print-resume compaction checks against a local HTTP test server.

Linux downloads

All packages target x86_64 Linux. The GNU tarball is built on Debian 12 with a glibc 2.36 / OpenSSL 3 compatibility baseline. Build provenance is included in every package. SHA-256 checksum files accompany the tarball, DEB, and RPM.

Codeberg is the primary release host; GitHub carries the same assets as a backup mirror.

Debian / Ubuntu

curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.12/ferrum_0.7.12_amd64.deb
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.12/ferrum_0.7.12_amd64.deb.sha256
sha256sum -c ferrum_0.7.12_amd64.deb.sha256
sudo apt install ./ferrum_0.7.12_amd64.deb
ferrum --version

Fedora / RHEL / openSUSE

curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.12/ferrum-0.7.12-1.x86_64.rpm
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.12/ferrum-0.7.12-1.x86_64.rpm.sha256
sha256sum -c ferrum-0.7.12-1.x86_64.rpm.sha256
sudo dnf install ./ferrum-0.7.12-1.x86_64.rpm
ferrum --version

On openSUSE, use sudo zypper install ./ferrum-0.7.12-1.x86_64.rpm instead.

GNU tarball

curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.12/ferrum-v0.7.12-x86_64-unknown-linux-gnu.tar.gz
curl -fLO https://codeberg.org/ominiverdi/ferrum/releases/download/v0.7.12/ferrum-v0.7.12-x86_64-unknown-linux-gnu.tar.gz.sha256
sha256sum -c ferrum-v0.7.12-x86_64-unknown-linux-gnu.tar.gz.sha256
tar xzf ferrum-v0.7.12-x86_64-unknown-linux-gnu.tar.gz
sudo install -Dm755 ferrum-v0.7.12-x86_64-unknown-linux-gnu/ferrum /usr/local/bin/ferrum
sudo install -Dm644 ferrum-v0.7.12-x86_64-unknown-linux-gnu/docs/ferrum.1 /usr/local/share/man/man1/ferrum.1
ferrum --version

From source with Cargo

git clone --branch v0.7.12 --depth 1 https://codeberg.org/ominiverdi/ferrum.git
cd ferrum
cargo install --path . --locked --force
ferrum --version

Full changes: https://codeberg.org/ominiverdi/ferrum/compare/v0.7.11...v0.7.12