Poetry is a tool for dependency management and packaging in Python. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you.

System requirements

Poetry requires Python 2.7 or 3.4+. It is multi-platform and the goal is to make it work equally well on Windows, Linux and OSX.


Poetry provides a custom installer that will install poetry isolated from the rest of your system by vendorizing its dependencies. This is the recommended way of installing poetry.

curl -sSL | python


You only need to install Poetry once. It will automatically pick up the current Python version and use it to create virtualenvs accordingly.

The installer installs the poetry tool to Poetry's bin directory. On Unix it is located at $HOME/.poetry/bin and on Windows at %USERPROFILE%\.poetry\bin.

This directory will be in your $PATH environment variable, which means you can run them from the shell without further configuration. Open a new shell and type the following:

poetry --version

If you see something like Poetry 0.12.0 then you are ready to use Poetry. If you decide Poetry isn't your thing, you can completely remove it from your system by running the installer again with the --uninstall option or by setting the POETRY_UNINSTALL environment variable before executing the installer.

python --uninstall

If you want to install prerelease versions, you can do so by passing --preview to or by using the POETRY_PREVIEW environment variable:

python --preview

Similarly, if you want to install a specific version, you can use --version or the POETRY_VERSION environment variable:

python --version 0.12.0
POETRY_VERSION=0.12.0 python


Note that the installer does not support Poetry releases < 0.12.0.


Using alternative installation methods will make Poetry always use the Python version for which it has been installed to create virtualenvs.

So, you will need to install Poetry for each Python version you want to use and switch between them.

Installing with pip

Using pip to install Poetry is possible.

pip install --user poetry


Be aware that it will also install Poetry's dependencies which might cause conflicts with other packages.

Installing with pipsi

Using pipsi to install Poetry is also possible.

pipsi install poetry

Make sure your installed version of pipsi is at least version 0.10, otherwise Poetry will not function properly. You can get it from its Github repository.

Updating poetry

Updating poetry to the latest stable version is as simple as calling the self:update command.

poetry self:update

If you want to install prerelease versions, you can use the --preview option.

poetry self:update --preview

And finally, if you want to install a specific version you can pass it as an argument to self:update.

poetry self:update 0.8.0


The self:update command will only work if you used the recommended installer to install Poetry.

Enable tab completion for Bash, Fish, or Zsh

poetry supports generating completion scripts for Bash, Fish, and Zsh. See poetry help completions for full details, but the gist is as simple as using one of the following:

# Bash
poetry completions bash > /etc/bash_completion.d/poetry.bash-completion

# Bash (macOS/Homebrew)
poetry completions bash > $(brew --prefix)/etc/bash_completion.d/poetry.bash-completion

# Fish
poetry completions fish > ~/.config/fish/completions/

# Zsh
poetry completions zsh > ~/.zfunc/_poetry


You may need to restart your shell in order for the changes to take effect.

For zsh, you must then add the following line in your ~/.zshrc before compinit:



当前网页内容, 由 大妈 ZoomQuiet 使用工具: ScrapBook :: Firefox Extension 人工从互联网中收集并分享;
若有不妥, 欢迎评注提醒:


订阅 substack 体验古早写作:

点击注册~> 获得 100$ 体验券: DigitalOcean Referral Badge

关注公众号, 持续获得相关各种嗯哼:


关于 ~ DebugUself with DAMA ;-)
公安备案号: 44049002000656 ...::