Skip to main content

Verda Python SDK

The official Verda (formerly DataCrunch) Python SDK.

The SDK's documentation is available on ReadTheDocs

Verda Public API documentation is available here.

This package was originally published under datacrunch name, see MIGRATION.md for details.

Getting Started - Using the SDK:

  • Install:

    # via pip
    pip install verda
    
    # via uv
    uv add verda
    
  • Generate your client credentials - instructions in the public API docs.

  • Add your client id and client secret to an environment variable (don't want it to be hardcoded):

    Linux (bash):

    export VERDA_CLIENT_ID=YOUR_ID_HERE
    export VERDA_CLIENT_SECRET=YOUR_SECRET_HERE
    
  • To enable sending inference requests from SDK you must generate an inference key - Instructions on inference authorization

  • Add your inference key to an environment variable

    Linux (bash):

    export VERDA_INFERENCE_KEY=YOUR_API_KEY_HERE
    

    Other platforms: https://en.wikipedia.org/wiki/Environment_variable

  • Example for creating a new instance:

    import os
    from verda import VerdaClient
    from verda.constants import Actions
    
    # Get credentials from environment variables
    CLIENT_ID = os.environ['VERDA_CLIENT_ID']
    CLIENT_SECRET = os.environ['VERDA_CLIENT_SECRET']
    
    # Create client
    verda = VerdaClient(CLIENT_ID, CLIENT_SECRET)
    
    # Get all SSH keys
    ssh_keys = [key.id for key in verda.ssh_keys.get()]
    
    # Create a new instance
    instance = verda.instances.create(instance_type='1V100.6V',
                                      image='ubuntu-24.04-cuda-12.8-open-docker',
                                      ssh_key_ids=ssh_keys,
                                      hostname='example',
                                      description='example instance')
    
    # Delete instance
    verda.instances.action(instance.id, Actions.DELETE)
    

    More examples can be found in the /examples folder or in the documentation.

Development

Set up the local development environment

Prerequisite: install uv.

Clone the repository, create local environment and install dependencies:

git clone git@github.com:verda-cloud/sdk-python.git
cd sdk-python
uv sync

Run Tests

  • Execute all tests

    uv run pytest
    
  • Execute a single test file

    uv run pytest tests/unit_tests/test_file.py
    

Local Manual Testing

Create a file in the root directory of the project:

# example.py
from verda import VerdaClient

CLIENT_SECRET = 'secret'
CLIENT_ID = 'your-id'

# Create client
verda = VerdaClient(CLIENT_ID, CLIENT_SECRET)

Run it:

uv run python example.py

Generating the documentation

If added a new service, create a documentation template under api/services for that service.

cd docs
make html

Code style

# Lint
uv run ruff check

# Format code
uv run ruff format

Contact

You can contact us here, or open an issue in the repo.

Metadata

Release files for verda 1.25.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for verda 1.25.0
File Size Uploaded Provenance Actions
verda-1.25.0.tar.gz 35.7 kB Without provenance Details for verda-1.25.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for verda 1.25.0
File Interpreter ABI Platform Actions
verda-1.25.0-py3-none-any.whl Python 3 none any Details for verda-1.25.0-py3-none-any.whl

Total release size: 92.8 kB

Release files / verda-1.25.0.tar.gz

Download URL verda-1.25.0.tar.gz
Size 35.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e6e199bad28c4ac23dac9eb2e1b6796703017c02d1409a717ef72719937eb5df
BLAKE2b-256 checksum
How to use checksums
a90a46733fb622c48da58e819e6861388e05e02bd0435379c8b849ef8cd7fc43
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / verda-1.25.0-py3-none-any.whl

Download URL verda-1.25.0-py3-none-any.whl
Size 57.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f543d6972bce61765614a524a1f5856efa9971800cb7075dd1fc0fe033cb6ebf
BLAKE2b-256 checksum
How to use checksums
6cb2e0c7e277e817e0ed42262dcf4839a802a3c249aeceb7b54036bfacb1a994
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for verda 1.25.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page