import sys
import os

# Required: set QGIS prefix path before importing
os.environ["QT_QPA_PLATFORM"] = "offscreen"  # headless mode
from qgis.core import QgsApplication

qgs = QgsApplication([], False)  # False = no GUI
qgs.initQgis()

# Always call at end of script:
# qgs.exitQgis()

from qgis.core import (QgsVectorLayer, QgsProject,
                        QgsCoordinateReferenceSystem)

# CSV with columns: well_name,latitude,longitude
uri = (
    "file:///path/to/wells.csv"
    "?delimiter=,"
    "&xField=longitude"
    "&yField=latitude"
    "&crs=EPSG:4326"          # WGS84 geographic
)
layer = QgsVectorLayer(uri, "wells", "delimitedtext")
if not layer.isValid():
    raise RuntimeError("Failed to load CSV layer")
QgsProject.instance().addMapLayer(layer)