```{highlight} shell

```

# Installation

## Stable release

To install `pyglotaran_extras` for a new project, run this command in your terminal:

```console
$ uv init --bare
$ uv add pyglotaran_extras
```

This is the preferred method to install pyglotaran_extras, as it will always install the most recent stable release.
Additionally this will create a `uv.lock` file allowing you to recreate and share the same environment you use by running `uv sync --frozen`.

Or if you have an existing project and environment

```console
$ uv pip install pyglotaran_extras
```

If you don't have [uv] installed, see the [uv installation guide].

[uv]: https://docs.astral.sh/uv/
[uv installation guide]: https://docs.astral.sh/uv/getting-started/installation/

## From sources

The sources for pyglotaran_extras can be downloaded from the [Github repo].

You can either clone the public repository:

```console
$ git clone git://github.com/glotaran/pyglotaran-extras
```

Or download the [tarball]:

```console
$ curl -OJL https://github.com/glotaran/pyglotaran-extras/tarball/main
```

Once you have a copy of the source, you can install it with:

```console
$ uv pip install .
```

[github repo]: https://github.com/glotaran/pyglotaran-extras
[tarball]: https://github.com/glotaran/pyglotaran-extras/tarball/main