devbox

<picture>
 <source media="(prefers-color-scheme: dark)" srcset="assets/devbox_logo_dark.svg">
 <source media="(prefers-color-scheme: light)" srcset="assets/devbox_logo_light.svg">
 <img alt="Devbox logo." src="assets/devbox_logo_light.svg">
</picture>

# Devbox

### Instant, easy, and predictable development environments

[![Join Discord](https://img.shields.io/discord/903306922852245526?color=7389D8&label=discord&logo=discord&logoColor=ffffff&cacheSeconds=1800)](https://discord.gg/agbskCJXk2)
![License: Apache 2.0](https://img.shields.io/github/license/jetify-com/devbox)
[![version](https://img.shields.io/github/v/release/jetify-com/devbox?color=green&label=version&sort=semver)](https://github.com/jetify-com/devbox/releases)
[![tests](https://github.com/jetify-com/devbox/actions/workflows/cli-post-release.yml/badge.svg)](https://github.com/jetify-com/devbox/actions/workflows/cli-release.yml?branch=main)
[![Built with Devbox](https://www.jetify.com/img/devbox/shield_galaxy.svg)](https://github.com/jetify-com/devbox/blob/main/CONTRIBUTING.md)

## What is it?

[Devbox](https://www.jetify.com/devbox/) is a command-line tool that lets you
easily create isolated shells for development. You start by defining the list of
packages required by your development environment, and devbox uses that
definition to create an isolated environment just for your application.

In practice, Devbox works similar to a package manager like `yarn` – except the
packages it manages are at the operating-system level (the sort of thing you
would normally install with `brew` or `apt-get`). With Devbox, you can install
over [400,000 package versions](https://www.nixhub.io) from the Nix Package
Registry

Devbox was originally developed by [Jetify](https://www.jetify.com) and is
internally powered by `nix`.

## Demo

The example below creates a development environment with `python 3.10` and
`go 1.18`, even though those packages are not installed in the underlying
machine. You can run commands in the environment with `devbox run`, or start an
interactive shell in it with `devbox shell`:

![screen cast](assets/devbox_demo.svg)

## Installing Devbox

Use the following install script to get the latest version of Devbox:

```sh
curl -fsSL https://raw.githubusercontent.com/jetify-com/devbox/main/install.sh | bash
```

The script ([install.sh](install.sh)) downloads the latest stable
[GitHub release](https://github.com/jetify-com/devbox/releases/latest), checks
its SHA-256 checksum, and installs it to `/usr/local/bin/devbox`. Pass `-f` to
skip the confirmation prompt. After that, devbox keeps itself up to date from
GitHub releases (`devbox version update`).

Read more on the
[Devbox docs](https://www.jetify.com/docs/devbox/installing-devbox/).

## Benefits

### A consistent shell for everyone on the team

Declare the list of tools needed by your project via a `devbox.json` file and
run `devbox shell`. Everyone working on the project gets a shell environment
with the exact same version o