APIPython

kscale Python API

⚠️

This API is currently under construction.

The Python API lets you interact with the K-Scale platform programmatically.

Usage

Here is an example of how to use the Python API to upload and download URDF files. Note that there are both asynchronous and synchronous versions of each function. The asynchronous version is preferred for performance (the synchronous version simply wraps the asynchronous version with asyncio.run).

import asyncio
from kscale import K
 
async def main() -> None:
    api = K()
 
    # Upload a URDF file to the K-Scale platform.
    await api.upload_urdf("listing_id", Path("path/to/urdf/root/"))  # Asynchronous version
    api.upload_urdf_sync("listing_id", Path("path/to/urdf/root/"))  # Synchronous version
 
    # Download and cache the URDF file from the K-Scale platform.
    urdf_path = await api.urdf_path("artifact_id")  # Asynchronous version
    urdf_path = api.urdf_path_sync("artifact_id")  # Synchronous version
 
if __name__ == "__main__":
    asyncio.run(main())