akash-akya/vix
67.4
Adequate · 15 November 2026
5.6k
lines of production code
Elixir
with C
5
measurements over time
What this system is
Features
Add new interactive livebooks for image processing examples
Added four new Livebook notebooks to the \livebooks/\ directory to demonstrate Vix capabilities: \introduction.livemd\ provides a comprehensive guide to Vix setup and core operations; \picture-language.livemd\ implements SICP-style picture language primitives; \rainbow.livemd\ demonstrates color generation and complex number operations; and \auto\_correct\_rotation.livemd\ shows document rotation correction using Fourier transforms. These notebooks utilize the Kino library for interactive inputs and rendering.
livebooks · high confidence
Add precompiled libvips binary support for multiple architectures
The build process now downloads and extracts precompiled libvips binaries (v8.18.7-rc1) from the sharp-libvips releases instead of compiling from source. This change adds support for Linux (musl and gnu), macOS (Intel and Apple Silicon), and Windows across x86\_64, ARM64, and ARMv7 architectures, significantly reducing compilation time and dependencies for users on these platforms.
_build\scripts · high confidence
Initial release of the Vix NIF library with configurable build modes and improved error handling
This change introduces the Vix C source code, establishing the core NIF bindings for libvips. It adds configurable build modes (precompiled vs platform-provided libvips) via the Makefile, implements robust error handling using \vips\_error\_buffer\_copy\ to prevent race conditions, and introduces configurable logging that is disabled by default but can be enabled for warnings or errors. The codebase also includes new NIF functions for image operations, foreign format support, and pipe-based I/O, along with proper resource cleanup and memory management.
_c\src · high confidence
Introduce mutable image operations and comprehensive VIPS type system
This change adds a new \Vix.Vips.MutableImage\ API that allows in-place modification of images via a GenServer-backed workflow, including metadata updates (\set\, \update\, \remove\, \get\), shape/band introspection, and the execution of mutable VIPS operations (such as drawing functions) through \MutableImage.run\_operation/2\. It also introduces a robust type system for VIPS data structures, adding dedicated modules for \Array\, \Blob\, \RefString\, \Enum\, \Flag\, \Interpolate\, \Source\, and \Target\, alongside a new \Vix.Vips.Foreign\ module for discovering supported load/save formats and suffixes. The \Vix.Vips.Image\ module is enhanced with full \Access\ behavior support for intuitive band extraction and dimensional slicing (e.g., \image\[0\]\, \image\[0..1\]\, \image\[\[width: 0..99\]\]\), and the \Operation\ module is expanded to expose dynamically generated immutable and mutable operation functions with proper typespecs and error handling.
lib/vix/vips · high confidence
New build scripts for custom libvips and mirrored musl toolchains
Added three new shell scripts to streamline the build environment: \build\_libvips.sh\ allows developers to download, compile, and install a specific version of libvips into a private prefix for local testing; \download\_toolchains.sh\ fetches musl cross-compilation toolchains (x86\_64 and aarch64) with a fallback to the official musl.cc source if the project's GitHub release mirror is unavailable; and \mirror\_toolchains.sh\ provides a utility to download these toolchains from musl.cc and prepare them for upload as GitHub release assets.
scripts · high confidence
Removals
Removal of Eips module
The Eips module has been removed from the library. This eliminates the previously available Eips.hello/0 function, which returned the atom :world, effectively removing this basic utility from the public API.
lib · high confidence
Behavioural changes
Improved error handling for mutable VIPS operations
The library now provides better error reporting when callers pass invalid arguments to mutable VIPS operations. A new \Vix.Vips.Operation.Error\ exception module and helper logic ensure that argument validation errors are raised clearly in the caller context rather than causing silent failures or crashes, while also excluding deprecated arguments from the operation signature.
lib/vix/vips/operation · high confidence
Introduce Vix as a libvips wrapper with operator overloading and source/target streaming
The library has been renamed from Vix to Vix and restructured to provide a comprehensive interface for libvips. Users can now use familiar arithmetic and relational operators (e.g., \+\, \==\) directly on images via \Vix.Operator\, which returns images instead of booleans for comparisons. The API now supports streaming I/O through \Vix.SourcePipe\ and \Vix.TargetPipe\, allowing images to be loaded from and saved to custom binary sources and targets without intermediate files. Additionally, raw pixel data can be exported to Nx-compatible tensors via \Vix.Tensor\, and memory management is handled by a dedicated \Janitor\ process to prevent leaks.
lib/vix · high confidence
Introduce explicit type handlers for GObject parameters
The library now uses dedicated modules (Boolean, Double, Int, String, UInt64) under Vix.GObject to handle type conversion and validation for GObject parameters. These modules implement the Type behaviour, providing explicit Elixir typespecs, default value extraction, and validation logic (such as UTF-8 string validation and numeric range checks) when converting between Elixir and NIF terms. Additionally, GParamSpec handling has been updated to correctly identify and map specific types like enums, flags, and VipsArray variants, ensuring that parameter metadata is accurately reflected in the Elixir API.
_lib/vix/g\object · high confidence
Project renamed to Vix with updated documentation and build tooling
The package has been renamed from Eips to Vix, reflected in the README, .gitignore, and the addition of a LICENSE file. The project now includes a Nix-based development environment (flake.nix, flake.lock) and a Makefile to streamline native builds. Documentation has been expanded with a DEVELOPMENT.md guide, and a Credo configuration (.credo.exs) has been added to enforce code quality standards.
(repo-wide) · high confidence
Refactored GObject resource management and parameter handling
The C NIF layer for GObject integration has been restructured to improve stability and type safety. Resource cleanup for GObject, GBoxed, and GParamSpec instances is now offloaded to a dedicated janitor process to prevent scheduler blocking during garbage collection. Additionally, the system now correctly handles GParamSpec details for various types (enums, flags, integers, doubles, strings) and ensures proper bidirectional conversion between Erlang/Elixir terms and GValues, including support for UTF-8 strings and 64-bit integers.
_c\_src/g\object · high confidence
Removal of legacy application configuration file
The \config/config.exs\ file has been removed from the project. This file previously contained default application configuration settings and dependency configurations using the \Mix.Config\ module. Its removal eliminates compiler warnings associated with this legacy configuration structure, implying that configuration management has been migrated elsewhere (likely to \mix.exs\ or environment-specific files) or is no longer required in this form.
config · high confidence
Test coverage
Added benchmark suite for image I/O and operations; Added raw pixel test data for image loading tests; Added test coverage for Vips image access, mutability, and data types; Added test coverage for foreign operations, NIF internals, and operator overloads; Added test support module for image comparison utilities; Added tests for GObject string handling; Added tests for Vips Operation Helper; Clean up test suite and configure logging.
Dependencies
Vix 0.42.0 release with libvips 8.18.7 and configurable compilation modes
The Vix library has been upgraded to version 0.42.0, bundling libvips 8.18.7. This release introduces configurable compilation modes (PRECOMPILED\_NIF\_AND\_LIBVIPS, PRECOMPILED\_LIBVIPS, PLATFORM\_PROVIDED\_LIBVIPS) allowing users to choose between precompiled binaries and platform-provided libraries. It also adds support for ARM architectures (armv7l, aarch64) and Linux musl builds, updates the minimum Elixir requirement to 1.12, and includes a new benchmarking suite in the bench directory using Benchee.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 68 → 67 (-0.3)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 95 → 95 (-0.7)
- Architecture 99 → 99 (-0.2)
- Maturity 58 → 58 (+0.0)
- Readiness 63 → 67 (+3.4)
- Security 83 → 75 (-8.3)
- Performance 85 → 85 (+0.0)
Resolved (3)
- No checksums published for release artifacts
- Outdated: elixir_make
- Outdated: ex_doc
New (3)
- Edited copy of a member (13 corresponding lines) (lib/vix/operator.ex)
- Edited copy of a member (26 corresponding lines) (lib/vix/vips/operation/helper.ex)
- Edited copy of a member (5 corresponding lines) (lib/vix/vips/image.ex)
Changes since last survey
- 17 commits — 13 feature/other, 4 fixes
By area
- (root) — 6 commits
- (repo) — 5 commits
- lib/vix — 2 commits
- .github/workflows — 1 commit
- build_scripts/precompiler.exs — 1 commit
- c_src/g_object — 1 commit
- c_src/vips_operation.c — 1 commit
Notable commits
- fix: Fix CI: move off retired macOS 14 runner, bump actions
- fix: Fix memory leak on libvips operation cache hits
- fix: Merge pull request #230 from akash-akya/fix-operation-cache-leak
- fix: Merge pull request #231 from akash-akya/fix-resource-cleanup
- change: Add libvips blocking, kill and tracking APIs
- change: Bump precompiled libvips to v8.18.7-rc2
- change: Bump version to 0.42.1
- change: Bump version to 0.43.0
- change: Free native resources on cleanup threads instead of the Janitor
- change: Include image in header_value/2 return spec
- change: Merge pull request #225 from miguelcoba/httpc-max-header-size
- change: Merge pull request #229 from akash-akya/deps-update-elixir-make
- change: Merge pull request #232 from akash-akya/libvips-security-apis
- change: Store dialyzer PLTs in priv/plts
- change: Update DEVELOPMENT.md for sharp-libvips v8.18.7-rc2
- change: Update deps and require elixir_make 0.10.1
- change: Use Bootlin musl toolchains for precompiled NIFs
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
akash-akya/vix was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 6a132a7728f58260d731d1cf382a241f04585cb0 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.