Docs

Install Evlet

You install Evlet once, as a command called evlet. We recommend uv to install it. uv is a fast installer for Python tools, and it finds or downloads a suitable Python for you.

#1. Install uv

Pick the line for your system. These are uv's official install commands.

macOS and Linux:

Terminal
curl -LsSf https://astral.sh/uv/install.sh | sh

macOS with Homebrew:

Terminal
brew install uv

Windows, in PowerShell:

Terminal
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Open a new terminal, then check that uv works:

Terminal
uv --version

For other ways to install uv, such as WinGet or pipx, see uv's installation guide.

#2. Install Evlet

Terminal
uv tool install evlet

This installs the newest Evlet from PyPI into a place of its own and puts the evlet command on your path. You do not need to create or activate a virtual environment.

Python. Evlet needs Python 3.12 or newer. You do not have to install it first: if uv finds no suitable Python on your computer, it downloads one for Evlet. To ask for a particular version, name it:

Terminal
uv tool install --python 3.12 evlet

A particular Evlet version. These docs are written for Evlet 0.4.3. To install exactly that version, run uv tool install evlet==0.4.3. Note that uv tool upgrade evlet then keeps that version until you install again without the ==. See Upgrade Evlet.

#3. Check it

Terminal
evlet --help
uv tool list

evlet --help lists every command. uv tool list shows the installed version, for example evlet v0.4.3.

If your terminal says evlet: command not found, uv's command folder is not on your path yet. Run uv tool update-shell, then open a new terminal.

#What you installed

There are two copies of Evlet in your work, and it helps to know both:

CopyWhere it livesWhat it is for
The evlet commanduv's tool folderCreating projects, and running commands from anywhere.
Each project's Evletmyproject/.venv/Running that project's apps and sites.

evlet setup myproject gives each project its own .venv with the same Evlet version as your evlet command. After that, every evlet command you run inside the project uses the project's own copy. So one project can stay on an older version while you try a newer one elsewhere. It also means upgrading is two steps, which Upgrade Evlet explains.

#Install with pip instead

If you prefer pip, use a virtual environment with Python 3.12 or newer:

Terminal
python3 -m venv .venv
source .venv/bin/activate
python -m pip install evlet

On Windows, activate it with .venv\Scripts\Activate.ps1. With pip, the evlet command only works while that environment is active.

#Next

Create your first project in Get started.