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:
curl -LsSf https://astral.sh/uv/install.sh | shmacOS with Homebrew:
brew install uvWindows, in PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Open a new terminal, then check that uv works:
uv --versionFor other ways to install uv, such as WinGet or pipx, see uv's installation guide.
#2. Install Evlet
uv tool install evletThis 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:
uv tool install --python 3.12 evletA 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
evlet --help
uv tool listevlet --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:
| Copy | Where it lives | What it is for |
|---|---|---|
The evlet command | uv's tool folder | Creating projects, and running commands from anywhere. |
| Each project's Evlet | myproject/.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:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install evletOn 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.