Python SDK

pip install nen-sdk-python

uv add nen-sdk-python

from nen_sdk import NenDesktop

client = NenDesktop(api_key="sk_nen_...")

# Create a desktop
desktop = client.create_desktop()
did = desktop.desktop_id

# Take a screenshot
result = client.screenshot(did)
# result.base64_image is a PNG, base64-encoded

# Click and type
client.left_click(did, 500, 400)
client.type_text(did, "hello world")

# Clean up
client.delete_desktop(did)

client = NenDesktop(
    api_key="sk_nen_...",
    base_url="https://desktop.api.getnen.ai",  # default
    timeout=30.0,                               # default (seconds)
)

with NenDesktop(api_key="sk_nen_...") as client:
    desktop = client.create_desktop()
    # ...
    client.delete_desktop(desktop.desktop_id)

# Upload, list, then download.
with open("report.pdf", "rb") as f:
    up = client.upload_file(did, "report.pdf", f, content_type="application/pdf")
    print(up.size, "bytes uploaded as", up.filename)

for entry in client.list_files(did):
    suffix = "/" if entry.is_dir else ""
    print(entry.name + suffix, entry.size)

# Round-trip within a subdirectory.
with open("report.pdf", "rb") as f:
    client.upload_file(did, "report.pdf", f, content_type="application/pdf", path="Documents")
for entry in client.list_files(did, path="Documents"):
    print(entry.name)
raw = client.download_file(did, "report.pdf", path="Documents")

from nen_sdk import NenDesktop, NenDesktopError, NotFoundError, AuthenticationError

client = NenDesktop(api_key="sk_nen_...")

try:
    client.get_desktop("dsk_nonexistent")
except NotFoundError as e:
    print(f"Not found ({e.status_code})")
except AuthenticationError as e:
    print(f"Auth failed ({e.status_code})")
except NenDesktopError as e:
    print(f"API error {e.status_code}: {e.response_body}")