ModuleNotFoundError: No module named 'dotenv'
Pachetul care oferă load_dotenv() nu e instalat în mediul Python în care rulezi programul. Instalează-l cu pip install python-dotenv (pachetul se numește python-dotenv, nu dotenv), în același mediu virtual în care rulezi codul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul spune că instrucțiunea from dotenv import load_dotenv (sau import dotenv) nu găsește niciun modul cu numele dotenv în interpretorul Python care rulează acum programul.
Capcana e numele: modulul se importă ca dotenv, dar pachetul de pe PyPI se numește python-dotenv. Comanda pip install dotenv instalează alt pachet sau eșuează, iar eroarea rămâne. A doua cauză frecventă: ai instalat pachetul, dar în alt mediu decât cel folosit de program (alt venv, alt Python din IDE, un container fără requirements.txt actualizat).
În stiva de apeluri, linia indicată este chiar importul. Nimic din codul de după nu a rulat, deci nici cheia API nu a fost citită.
De ce apare: cauzele frecvente
1Ai instalat pachetul cu numele greșit
pip install dotenvpip install python-dotenvNumele de import (dotenv) diferă de numele pachetului (python-dotenv). Doar al doilea instalează modulul cu load_dotenv().
2Pachetul e instalat în alt mediu
pip install python-dotenv
# programul rulează cu alt Python (alt venv / IDE)
python app.pysource .venv/bin/activate
python -m pip install python-dotenv
python app.pypython -m pip instalează exact în interpretorul pe care îl folosești și pentru python app.py, deci modulul e găsit.
3Lipsește din requirements.txt
# requirements.txt
anthropic
openai# requirements.txt
anthropic
openai
python-dotenvPe server sau în Docker se instalează doar ce e în requirements.txt. Dacă pachetul lipsește de acolo, eroarea apare doar la deploy.
Repară eroarea, direct în pagină
Editorul nostru nu are pachetul python-dotenv, așa că from dotenv import load_dotenv dă ModuleNotFoundError: No module named 'dotenv'. Scoate importul și scrie funcția incarca_env(), care citește fișierul .env și pune fiecare linie NUME=valoare în os.environ. Programul afișează apoi începutul cheii și răspunsul asistentului.
import os
import anthropic
from dotenv import load_dotenv
MODEL = "claude-haiku-5-5"
load_dotenv()
cheie = os.environ.get("ANTHROPIC_API_KEY")
print("Cheie găsită:", cheie[:7] + "...")
client = anthropic.Anthropic()
r = client.messages.create(
model=MODEL,
max_tokens=200,
messages=[{"role": "user", "content": "Cât durează livrarea în Cluj?"}],
)
print(r.content[0].text)Cheie găsită: sk-ant-... Livrarea în Cluj durează 1–2 zile lucrătoare.
Indiciu
Deschide .env, sari peste liniile goale și comentarii, desparte fiecare linie cu split("=", 1) și scrie în os.environ.
Reparația
import os
import anthropic
MODEL = "claude-haiku-5-5"
def incarca_env(cale=".env"):
with open(cale, encoding="utf-8") as f:
for linie in f:
linie = linie.strip()
if not linie or linie.startswith("#") or "=" not in linie:
continue
nume, valoare = linie.split("=", 1)
os.environ[nume.strip()] = valoare.strip()
incarca_env()
cheie = os.environ.get("ANTHROPIC_API_KEY")
print("Cheie găsită:", cheie[:7] + "...")
client = anthropic.Anthropic()
r = client.messages.create(
model=MODEL,
max_tokens=200,
messages=[{"role": "user", "content": "Cât durează livrarea în Cluj?"}],
)
print(r.content[0].text)De ce merge
load_dotenv() nu face nimic magic: citește .env și copiază perechile NUME=valoare în os.environ. Funcția ta face același lucru cu biblioteca standard, deci nu mai depinde de un pachet care lipsește. După încărcare, anthropic.Anthropic() găsește singur ANTHROPIC_API_KEY. În proiectul tău poți păstra load_dotenv(), cu condiția să instalezi pachetul corect, python-dotenv, în mediul în care rulezi.
Alte forme ale mesajului
ModuleNotFoundError: No module named 'python_dotenv'
Cum o eviți pe viitor
- Instalează cu
python -m pip install python-dotenv, din mediul virtual activat al proiectului. - Adaugă
python-dotenvînrequirements.txtimediat ce îl folosești. - Verifică interpretorul ales în IDE: trebuie să fie cel din
.venv. - În producție, setează variabilele de mediu direct pe server; acolo
.envșipython-dotenvnu sunt obligatorii.
Întrebări frecvente
Am rulat pip install dotenv și tot nu merge. De ce?
Pentru că pachetul corect este python-dotenv. Dezinstalează-l pe cel greșit cu pip uninstall dotenv și instalează python-dotenv. Importul rămâne from dotenv import load_dotenv.
Am nevoie neapărat de python-dotenv ca să citesc cheia API?
Nu. SDK-urile citesc cheia din variabila de mediu ANTHROPIC_API_KEY sau OPENAI_API_KEY. python-dotenv doar copiază liniile din .env în os.environ, ceea ce poți face și cu câteva linii de cod sau setând variabila în terminal.
Erori înrudite
KeyError: 'ANTHROPIC_API_KEY' Codul citește cheia cu os.environ["ANTHROPIC_API_KEY"], dar variabila de mediu nu există în procesul în care rulează programul. Setează variabila (sau încarcă fișierul .env cu load_dotenv() înainte de citire) și folosește os.environ.get(...) cu un mesaj clar când lipsește. ModuleNotFoundError: No module named 'anthropic' Python nu găsește pachetul `anthropic` (sau `openai`) în mediul în care rulezi programul. Instalează-l cu `pip install anthropic` în același mediu (venv) cu care rulezi scriptul și verifică dacă numele din `import` e scris corect. anthropic.AuthenticationError: Error code: 401 - {'type': 'error', 'error': {'type': 'authentication_error', 'message': 'invalid x-api-key'}} API-ul Claude a respins cheia trimisă: e greșită, expirată, ștearsă sau e o cheie de la alt furnizor. Pune o cheie validă de la Anthropic (începe cu `sk-ant-`) în variabila de mediu `ANTHROPIC_API_KEY` și creează clientul fără `api_key=` în cod. Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție
Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.
