...
Eroare Aplicații AI cu LLM · Instalare, import, chei API și facturare

ModuleNotFoundError: No module named 'dotenv'

Pe scurt

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

Greșit
PYTHON
pip install dotenv
Corect
PYTHON
pip install python-dotenv

Numele de import (dotenv) diferă de numele pachetului (python-dotenv). Doar al doilea instalează modulul cu load_dotenv().

2Pachetul e instalat în alt mediu

Greșit
PYTHON
pip install python-dotenv
# programul rulează cu alt Python (alt venv / IDE)
python app.py
Corect
PYTHON
source .venv/bin/activate
python -m pip install python-dotenv
python app.py

python -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

Greșit
PYTHON
# requirements.txt
anthropic
openai
Corect
PYTHON
# requirements.txt
anthropic
openai
python-dotenv

Pe server sau în Docker se instalează doar ce e în requirements.txt. Dacă pachetul lipsește de acolo, eroarea apare doar la deploy.

Repară tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
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.

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 în requirements.txt imediat 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 și python-dotenv nu 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

← Toate erorile Aplicații AI cu LLM

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.