Installation

Officially supported platforms:

• Linux x86_64
• Linux arm64
• macOS Apple Silicon arm64

Intel macOS is currently out of scope.

pip install adaup

System-Wide Installation

sudo pip install --upgrade adaup --break-system-packages

After installation, the cardano executable will be available in your PATH.

Usage

The cardano executable provides a command-line interface to manage Cardano nodes and related tooling.

Running a Cardano Node

Start a Cardano node for a specific network:

cardano node preview
cardano node mainnet

For a local single-node development network with prepackaged genesis material and an auto-funded default wallet in ~/.cardano/keys, use:

cardano node devnet

This starts a local node at ~/.cardano/devnet/node.socket using cardano-node 11.0.1, regenerates payment.*, stake.*, and payment.addr under ~/.cardano/keys on each run, and funds that address with 1000000000000 lovelace (1,000,000 ADA) from the devnet faucet.

Running Cardano CLI Commands

Use the cli subcommand followed by regular cardano-cli arguments:

export CARDANO_NODE_SOCKET_PATH=~/.cardano/preview/node.socket
cardano cli query tip --testnet-magic 2
cardano cli query tip --testnet-magic=2 --socket-path=~/.cardano/preview/node.socket

Additional Guides

• Hydra cluster setup and operations: Hydra Guide

Binary Sources

• cardano node and cardano cli use official GitHub release assets from IntersectMBO/cardano-node.
• cardano mithril uses the official Mithril installer script.
• cardano hydra resolves binaries in this order:
  1. ADAUP_HYDRA_NODE_PATH and ADAUP_HYDRA_TUI_PATH
  2. Existing hydra-node and hydra-tui in PATH
  3. ADAUP_HYDRA_DOWNLOAD_URL
  4. GitHub Actions artifacts from ADAUP_HYDRA_ACTIONS_RUN_URL

For Hydra Actions artifacts, adaup resolves the artifact from the public GitHub Actions run and downloads it through a public nightly.link URL. The default bundled Hydra version 2.2.0 points to the successful release run 27418396480.