Getting started

Install #

This is Agentica 0.33.0. Release 0.33.0 has the source archive of that version and the five prebuilt archives that the release workflow builds (Linux x86-64, Linux ARM64, Windows x86-64, macOS Intel and macOS Apple silicon), with a SHA256SUMS file. All releases lists the other versions.

Download the archive of your system, check it against SHA256SUMS, unpack it anywhere (spaces and non-ASCII letters are fine) and put its bin folder on your PATH. It holds one program and needs no other library.

SystemArchiveMinimum
Linux x86-64agentica-VERSION-linux-x86_64.tar.gzglibc 2.28
Linux ARM64agentica-VERSION-linux-arm64.tar.gzglibc 2.28
macOS Intelagentica-VERSION-macos-x86_64.tar.gzmacOS 12
macOS Apple siliconagentica-VERSION-macos-arm64.tar.gzmacOS 12, native (no Rosetta)
Windows x86-64agentica-VERSION-windows-x86_64.zipWindows 10 (system DLLs and the UCRT; no MSYS2 or Visual C++ redistributable)
sha256sum -c --ignore-missing SHA256SUMS   # macOS: shasum -a 256 -c ... ; Windows: Get-FileHash
tar -xzf agentica-VERSION-linux-x86_64.tar.gz   # Windows: Expand-Archive
  • The archives are not developer-signed or notarized (macOS programs carry only the ad hoc signature Apple silicon requires). SHA256SUMS is the only proof of origin.
  • macOS blocks a browser download: run xattr -d com.apple.quarantine bin/agentica (a curl download has no mark). Windows SmartScreen may warn once.
  • TCP, TLS and std/http run and are tested on Linux, macOS and Windows.

Build from source #

Needs a C11 compiler and make; on Linux also libssl-dev, libgc-dev, zlib1g-dev and pkg-config (OpenSSL 3, libgc 8.2 or newer, zlib). The build starts from the checked-in bootstrap/stage0.agcb and needs no other tool. It also runs on macOS (Xcode command line tools) and Windows (MSYS2 UCRT64 with GCC).

git clone https://github.com/agentica-lang/agentica.git
cd agentica
git submodule update --init
make    # writes dist/agentica

A default build links the system OpenSSL, so dist/agentica runs only where it is installed; the release archive is portable. AGENTICA_GC=vendored, AGENTICA_OPENSSL=vendored and AGENTICA_ZLIB=vendored build the bundled copies, each on its own (only OpenSSL needs Perl 5 and a few minutes). Pass them to every make command, or export them.

Hello, world #

def main() -> Void # every program starts at main
  puts("Hello, world!")
end

Save it as hello.agc and run it:

agentica hello.agc
Output
Hello, world!

Check #

agentica check hello.agc checks types without running and prints check ok, or an error with a stable code such as CHECK-TYPE-MISMATCH (Check and errors).

Next #

Take the language tour, then look up the builtins in the library.