Skip to content
CAI
Software that uses CAICheck a score

akash-akya/vix

67.4

Adequate · 15 November 2026

5.6k

lines of production code

Elixir

with C

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.