# Install clarinet with Homebrew, winget

Command-line tool and runtime for the Clarity smart contract language. Version 3.23.1 via Homebrew; verified 2026-07-31. Also installable with winget: winget install --id HiroSystems.Clarinet -e.

## 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
- **Version:** 3.23.1
- **Source summary:** Command-line tool and runtime for the Clarity smart contract language
- **Homepage:** <https://stackslabs.com/>
- **Repository:** <https://github.com/stx-labs/clarinet>
- **Last updated:** 2026-07-31T21:28:45Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- clarinet (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 3.23.1
## 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

- <https://github.com/stx-labs/clarinet#readme>
- <https://docs.stacks.co/clarinet/overview.md>
- <https://docs.stacks.co/reference/clarinet/cli-reference.md>
- <https://api.github.com/repos/stx-labs/clarinet>
- <https://api.github.com/repos/stx-labs/clarinet/releases>
- <https://formulae.brew.sh/api/formula/clarinet.json>


## 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
## 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


## Combined YAML source

View the package source record on GitHub. [combined/clarinet.yml](https://github.com/mxcl/pkgdb/blob/main/combined/clarinet.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph