# Install clarinet with Homebrew, winget Command-line tool and runtime for the Clarity smart contract language. Version 3.21.1 via Homebrew; verified 2026-07-07. ## Install ```sh sudo av install brew:clarinet ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install clarinet ``` Evidence: local Homebrew formula metadata ### Windows - winget (92%): ```sh winget install --id HiroSystems.Clarinet -e ``` Evidence: Windows Package Manager source index: HiroSystems.Clarinet from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:clarinet - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.21.1 - **Source summary:** Command-line tool and runtime for the Clarity smart contract language - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-only - **Source archive:** - **Last updated:** 2026-07-07T02:25:55Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - clarinet (cli) - clarinet (alias) ## Build dependencies - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 3.21.1 - Package-manager updated: 2026-07-07 - Local data: ok - Upstream repository: https://github.com/stx-labs/clarinet - Upstream latest detected: v3.21.1 (current) ## Project history and usage Clarinet is the Stacks ecosystem's command-line development framework and Clarity runtime for writing, testing, debugging, and deploying Stacks smart contracts. ### Project history The public repository was created in 2020. Official Stacks documentation describes Clarinet as a development framework and Clarity runtime packaged as a command-line tool for smart contract understanding, development, testing, and deployment. The project expanded from a CLI into a suite that includes local devnet support, an interactive REPL, a JavaScript SDK/testing framework, and VS Code integration. By June 2026, GitHub releases had reached v3.21.0. ### Adoption history Official installation docs list Homebrew, winget, source builds, and binary releases. The README also badges an npm package for @stacks/clarinet-sdk and an Open VSX extension, showing adoption beyond the standalone CLI. Homebrew reported 988 installs over the prior 365 days for clarinet, and the input metadata also lists winget packaging as HiroSystems.Clarinet. ### How it is used Clarinet is used to create projects, add contracts, check syntax and types, run a console REPL, launch a local devnet, manage deployments, and write unit tests with the Clarinet SDK. ### Why package nerds care Clarinet is a useful package-manager case because a blockchain developer workflow is distributed through multiple channels: Homebrew for Unix-like CLI installs, winget and binary archives for direct installs, npm for the SDK, and editor marketplaces for the VS Code integration. ### Timeline - 2020: GitHub repository created. - 2026: v3.18.0 through v3.21.0 releases published in May and June. - 2026: Homebrew formula metadata lists v3.21.0 as the stable version. - 2026: Official docs list Homebrew, winget, source, and binary installation paths. ### Related projects - Clarinet is tied to the Clarity smart contract language and the Stacks blockchain. - The official docs point to LabSTX as a browser-based alternative and document Clarinet's SDK and VS Code extension as companion projects. ### Sources - - - - - - ## Security Notes generalized runtime or code generation signal. - **Geiger risk:** yellow / medium - generalized runtime or code generation signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ./Clarinet.toml, ./settings/Devnet.toml, ./settings/Testnet.toml, ./settings/Mainnet.toml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** clarinet - **Version Scheme:** 1 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - winget - HiroSystems.Clarinet: normalized package name match | Windows Package Manager source index: HiroSystems.Clarinet from https://cdn.winget.microsoft.com/cache/source.msix - winget - StacksLabs.Clarinet: normalized package name match | Windows Package Manager source index: StacksLabs.Clarinet from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [truffle](https://www.automicvault.com/pkg/brew/truffle/) - Shares av.db curated category or tags: blockchain, cli, developer-tools, smart-contracts, testing. - [anchor](https://www.automicvault.com/pkg/brew/anchor/) - Shares av.db curated category or tags: blockchain, cli, developer-tools, smart-contracts. - [chainhook](https://www.automicvault.com/pkg/brew/chainhook/) - Shares av.db curated category or tags: blockchain, cli, developer-tools, stacks. - [stellar-cli](https://www.automicvault.com/pkg/brew/stellar-cli/) - Shares av.db curated category or tags: blockchain, cli, developer-tools, smart-contracts. - [sui](https://www.automicvault.com/pkg/brew/sui/) - Shares av.db curated category or tags: blockchain, cli, developer-tools, smart-contracts. - [aiken](https://www.automicvault.com/pkg/brew/aiken/) - Shares av.db curated category or tags: blockchain, cli, developer-tools, smart-contracts. - [foundry](https://www.automicvault.com/pkg/brew/foundry/) - Shares av.db curated category or tags: blockchain, cli, developer-tools, smart-contracts. - [ignite](https://www.automicvault.com/pkg/brew/ignite/) - Shares av.db curated category or tags: blockchain, cli, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/clarinet.yml](https://github.com/automic-vault/db/blob/main/combined/clarinet.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph