Build From Source

Prerequisites

  • Rust (stable) with clippy, rustfmt, and llvm-tools-preview
  • CMake + a C/C++ toolchain
  • Xcode Command Line Tools (macOS)

One-Time Setup

# Native tracing deps (Frida SDKs, etc.)
./utils/init_third_parties.sh

# Bundled media tools used by ada query (ffmpeg, whisper-cli, models)
./utils/init_media_tools.sh

Build

# Build the ada CLI (and its workspace dependencies)
cargo build --release -p ada-cli

Smoke Test

./target/release/ada doctor check

Tests

cargo test --all

macOS Code Signing Notes

Some tracing scenarios require signed binaries (especially when running from SSH/CI). The repo includes signing helpers under ./utils/ and uses the APPLE_DEVELOPER_ID environment variable for Developer ID signing when needed.