Atlas CLI Development Guide

May 23, 2026 ยท View on GitHub

This guide contains information for developers who want to contribute to, build, or modify the Atlas ML CLI tool.

Development Environment Setup

Prerequisites

  • Rust (latest stable) - Install Rust
  • OpenSSL development libraries
  • Protobuf Compiler (for TDX attestation features)

Getting the Source Code

git clone https://github.com/IntelLabs/atlas-cli
cd atlas-cli

Development Tools

Install development dependencies:

make dev-deps

This installs:

  • cargo-watch for continuous compilation during development
  • cargo-edit for easier dependency management

Build Instructions

Standard Build

cargo build

Build with GCP TDX Attestation & Verification

apt install protobuf-compiler
cargo build --features with-tdx

Testing

Run the full test suite:

cargo test

Run tests with output:

make test-verbose

Watch for changes and run tests automatically:

make watch-test

Releases

This project adheres to Semantic Versioning. To publish a new release of atlas-cli, follow these steps:

  1. Update the Cargo.toml version field and run cargo update in the root directory
  2. Run cargo update in the examples directory
  3. Bump any references to the version number in source files (search via grep -r "<CURRENT_MAJOR>\.<CURRENT_MINOR>\.<CURRENT_PATCH>" ./src)
  4. Add a new entry to CHANGELOG.md
  5. Open a PR against the main branch with these changes
  6. Create a new release on GitHub with the tag v<NEW_MAJOR.NEW_MINOR.NEW_PATCH>
  7. Once the PR is merged, pull the latest head of main and new git tag, and follow the cargo publish steps