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
  
  # Get credentials from environment variables
  CLIENT_ID = os.environ.get('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, verda.constants.instance_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 [email protected]: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, base_url='http://localhost:3001/v1')

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.