AntflyAntfly

Downloads

Install Antfly#

One command on macOS or Linux:

curl -fsSL https://releases.antfly.io/antfly/latest/install.sh | sh

Or pin a specific version:

curl -fsSL https://releases.antfly.io/antfly/latest/install.sh | sh -s -- {ANTFLY_VERSION}

On macOS or Linux you can also use Homebrew:

brew install antflydb/taps/antfly

Either way you get the antfly binary: the native Zig runtime with Antfly Inference built in. From here, the Quickstart takes you to a running engine and your first query.

Platform Archives#

The full matrix of platform archives and checksums, for manual and automated installs:

For the Apache-2.0 embedded database and inference runtime, download the matching Embedded archive (for example, antfly-embedded_{ANTFLY_VERSION}_Linux_x86_64_gnu.tar.gz or antfly-embedded_{ANTFLY_VERSION}_Darwin_arm64.tar.gz). It contains antfly-lite, antfly-inference, libantfly, include/antfly.h, the private inference worker, runtime files, and license notices.

Run ./antfly-lite help for database commands or ./antfly-inference --help for inference commands. Python and npm bindings use the same native library and private worker without installing public CLI commands; Go and Rust consumers link the library from this archive or a local build.

Extract the binaries#

tar -xzf antfly_{ANTFLY_VERSION}_Darwin_arm64.tar.gz

Make the binaries executable#

chmod +x antfly

Remove the quarantine attribute#

xattr -dr com.apple.quarantine antfly

Ensure the binary is accessible#

Add the extracted directory to your PATH:

export PATH=$PATH:$(pwd)

Upgrading#

A new release may migrate table files in place when opening an existing data directory, and that migration can be one-way: an older binary may subsequently fail to open the directory with InvalidTableFile.

Create and verify a portable backup before upgrading, and restore that backup into a fresh data directory if you need to roll back. Do not rely on swapping the binary while reusing a directory that a newer release has opened.