Repository navigation
Ferrum v0.7.12
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
readtool. 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.--perfenables 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..86400for 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.
--sessionand--resumenow 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 = 180Restart Ferrum after editing provider configuration.
Dependency hardening
- Update Tokio to 1.53.3, addressing RUSTSEC-2026-0386.
- Replace deprecated
serde_yaml/ unmaintainedunsafe-libyamlwithserde-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
rustlsandrustls-webpkidependencies 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 warningspassed 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 --versionFedora / 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 --versionOn 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 --versionFrom 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 --versionFull changes: https://codeberg.org/ominiverdi/ferrum/compare/v0.7.11...v0.7.12