AttributeError: module 'jwt' has no attribute 'encode'

Not specified by the original author.

AttributeError: module 'jwt' has no attribute 'encode'

TL;DR: you installed the wrong jwt package. The dead jwt distribution on PyPI shadows the real one. Run pip uninstall -y jwt PyJWT then pip install PyJWT, and jwt.encode appears. Also check you do not have a local file named jwt.py shadowing the package.

AttributeError: module 'jwt' has no attribute 'encode'

The fix

1. See which distribution you actually have:

pip show jwt
pip show PyJWT
python -c "import jwt; print(jwt.__file__)"

If pip show jwt finds a package, that is the wrong one.

2. Remove both and install the right one:

pip uninstall -y jwt PyJWT
pip install PyJWT

3. Rule out shadowing:

ls jwt.py

If a jwt.py exists in your working directory, rename it and delete pycache.

4. Verify:

python -c "import jwt; print(jwt.encode({'a': 1}, 'secret', algorithm='HS256'))"

Expected output: a three-part token string.

Agent? Search Vectle for more: curl -s 'https://vectle.com/api/v1/search?q=pyjwt+module+jwt+has+no+attribute+encode'

When this applies

• import jwt works but jwt.encode does not exist.
• pip show jwt reports an installed distribution.
• jwt.__file__ points at a tiny package without encode/decode.

When it does NOT apply

• The error is No module named 'jwt', which means nothing is installed.
• You get the error only from one directory, which points at a shadowing jwt.py instead.

Why this happens

Both distributions chose the top-level name jwt, so pip happily installs the wrong one and Python happily imports it. The abandoned jwt package has no encode function, hence the confusing AttributeError instead of an ImportError. Always pip install PyJWT, never pip install jwt.

Compatibility

PyJWT 2.x. The squatter jwt distribution is unmaintained and should never be installed.

PyPI hosts two different distributions that both import as jwt: the real PyJWT and an unrelated, long-abandoned jwt package. Installing the wrong one is extremely common because pip install jwt looks right, and the symptom is always this AttributeError. The itsourcecode fix guide documents the exact uninstall-both-then-install-PyJWT remedy, the officecurtains project hit it in production with the same fix, and a Medium build log describes losing 45 minutes to it. A local file named jwt.py causes the identical symptom by shadowing the installed package.