Install Aner

Install the native Aner package for your operating system and processor, then add its bin directory to your PATH. The guides use aner run to execute programs and aner check to check them without execution.

Check Downloads for available versions and supported platforms. Public releases are being prepared, so a platform marked In preparation has no public download yet. If you have received a preview package, use the matching instructions below and its release notes.

Choose and unpack a package

Select the package matching both your operating system and architecture: Apple Silicon uses ARM64; Intel Macs and most Intel/AMD PCs use x86_64. An ARM64 Windows or Linux device needs its corresponding package. Availability and supported OS versions are listed with each release.

Download the package and its checksum information together.
Verify the archive against the published SHA-256 before extracting it. See binary package verification.
Extract it into a new folder you can keep, such as an application folder in your home directory. Keep its bin, examples, editor when included, and license notices together.
Open a terminal in the extracted folder and follow the commands for your system below.

The native package includes the interpreter and included modules needed to run these examples.

macOS and Linux

From the extracted package folder:

./bin/aner --version
export PATH="$PWD/bin:$PATH"
aner --version

The export applies to this terminal session. To keep the command available, add the actual absolute bin path to your shell startup file. For example, add export PATH="/absolute/path/to/aner/bin:$PATH" to ~/.zshrc for zsh or ~/.bashrc for an interactive bash terminal. Replace the example path with your extracted package's location, then open a new terminal.

Windows

From PowerShell in the extracted package folder:

.\bin\aner.exe --version
$env:Path = "$($PWD.Path)\bin;$env:Path"
aner --version

This updates the current PowerShell session. For future sessions, open Edit environment variables for your account, edit your user Path, and add the extracted package's absolute bin folder. Open a new terminal and restart VS Code afterward. Use the Windows package when it is available; a Linux or macOS executable cannot run directly in Windows.

Run a program

Create hello.aner in your own project folder:

print("Hello from Aner")

From that folder:

aner run hello.aner

For the bundled XOR example, run this from the extracted package folder containing examples/:

aner run examples/neural_xor.aner

You can also download examples into your project. Keep required fixture files in the documented relative locations. Relative input paths are resolved from the terminal's current working directory.

Set up VS Code and notebooks

Install the matching Aner VSIX supplied with the release using Extensions → … → Install from VSIX…. Restart VS Code after changing PATH. If automatic discovery cannot find Aner, set Aner: Notebook Executable to the full installed executable path. Follow the VS Code guide to edit .aner files and create .anernb notebooks.

VS Code is optional for terminal programs. On a remote machine, install the native package for that machine's OS and architecture.

Update or remove an installation

Extract a new version into its own folder, verify it, and update your PATH and any explicit VS Code executable setting. Keep your programs and datasets in a separate project folder. Restart notebook sessions before using the new executable, then run the cells again.

To remove an installation, remove its PATH entry and extracted package folder after preserving any files you saved there. Multiple version folders can coexist; aner --version tells you which executable your terminal currently selects.

If aner is not found, check that PATH contains the folder holding the executable, open a new terminal, or invoke the executable by its full path. If the OS rejects it, check the package's architecture, supported OS version, and release specific signing information.