OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Developer Tools

Clarinet

Clarinet is an open-source developer tool for writing, testing and deploying Clarity smart contracts for the Stacks blockchain and Bitcoin. It combines a CLI, local development environment, REPL, testing framework, debugging tools and editor support. The repository is primarily written in Rust and includes a Clarinet SDK for JavaScript and TypeScript-based testing and tooling.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Clarinet — OpenViST project profile in Developer Tools.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use Clarinet during Clarity contract development when you need project scaffolding, local checking, REPL interaction, testing or a local blockchain environment before working with deployed contracts.

Who it is for

  • Stacks smart-contract developers
  • Teams testing Clarity contracts locally
  • Developers building tooling with the Clarinet SDK
  • VSCode users who want Clarity linting, completion and debugging support

Documented uses

  • Create Stacks smart-contract projects and contracts
  • Manage contract dependencies with Clarinet requirements
  • Check Clarity code and interact with it through a REPL
  • Run local nodes, miners and APIs in a private development environment
  • Write JavaScript-based unit tests with the Clarinet SDK
Before you choose

Requirements & limits

The repository is public and identifies the project as GPL-3.0 open source. It provides CLI tooling and editor support; no pricing or account requirement is established here.

  • The tool targets Clarity contracts in the Stacks and Bitcoin ecosystem.
  • Its local devnet includes nodes, miners and APIs for development and integration work.
  • The SDK supports unit tests in a JavaScript environment.
  • VSCode support includes linting, autocompletion, documentation and step-by-step debugging.
  • The repository is primarily implemented in Rust, with a Rust WebAssembly component and TypeScript SDK wrapper.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Create and check a Clarity contract project

Create a Clarinet project, add a contract, check it and interact with it through the REPL.

Before you start

  • Clarinet installed; the repository documents Homebrew installation.
  • A terminal and a Clarity contract to place in the generated project.

Steps

  1. Install Clarinet with the documented Homebrew command.

  2. Create a project with clarinet new hello-world and enter its directory.

  3. Create a contract with clarinet contract new counter.

  4. Add the documented counter contract, run clarinet check, then launch clarinet console and call the contract functions shown in the README.

Expected outcome

A local Clarinet project with a checked Clarity contract and documented REPL calls for incrementing and reading a counter.

Guide limitations

  • The README documents the local creation, checking and REPL stages; it does not establish a successful network deployment from this recipe.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
2 October 2026
Original website title
stx-labs/clarinet · Official homepage title · retained in its source language
How we review sourcesSuggest a correction