Python SDK

pip install gumnut-sdk

uv add gumnut-sdk

from gumnut import Gumnut

client = Gumnut()

from datetime import datetime, timezone
from pathlib import Path

library_id = "lib_your_library_id"

asset = client.assets.create(
    asset_data=Path("photo.jpg"),
    device_asset_id="photo-001",
    device_id="batch-importer",
    file_created_at=datetime.now(timezone.utc),
    file_modified_at=datetime.now(timezone.utc),
    library_id=library_id,
)

album = client.albums.create(name="Vacation", library_id=library_id)
client.albums.assets_associations.add(
    album.id,
    asset_ids=[asset.id],
)

results = client.search.search(query="sunset at the beach")

for item in results.data:
    print(item.asset.id)

for asset in client.assets.list():
    print(asset.id)

page = client.assets.list()

while True:
    for asset in page.data:
        print(asset.id)

    if not page.has_next_page():
        break
    page = page.get_next_page()

import asyncio
from gumnut import AsyncGumnut


async def main() -> None:
    async with AsyncGumnut() as client:
        async for asset in client.assets.list():
            print(asset.id)


asyncio.run(main())

client = Gumnut(
    max_retries=4,
    timeout=30.0,
)

import gumnut

try:
    client.assets.retrieve("asset_missing")
except gumnut.RateLimitError:
    print("Rate limited; retry later")
except gumnut.APIStatusError as error:
    print(error.status_code)
except gumnut.APIConnectionError as error:
    print(f"Could not reach Gumnut: {error}")