License

PyPI - Version PyPI - Python Version

Modular SDK

You use Modular SDK to create, configure, and manage common entities, such as:

  • Customers;
  • Tenants;
  • TenantSettings;
  • Regions;
  • Applications;
  • Parents;

Prerequisites

  • Python 3.14 required

Building distribution archives

  • Make sure you have the latest version of PyPA’s build installed: python3 -m pip install --upgrade build
  • Run the command form the same directory where pyptoject.toml is located: python3 -m build
  • This command should output a lot of text and once completed should generate two files in the dist directory:
dist/
    modular_sdk-{version}.tar.gz
    modular_sdk-{version}-py3-none-any.whl

Installation

  • pip install modular-sdk

Usage

To use Modular SDK, you must import, configure and indicate which service or services you're going to use:

from modular_sdk.modular import Modular

modular_sdk = Modular()

parent_service = modular_sdk.parent_service()
tenant_service = modular_sdk.tenant_service()

For services that aren't tied to the service_mode configuration, you can use ModularServiceProvider:

from modular_sdk.modular import ModularServiceProvider

modular_sdk = ModularServiceProvider()

thread_local_storage_service = modular_sdk.thread_local_storage_service()

For now, Modular provides 3 ways of DB access. Depends on the way of database connection, different sets of env variables must be set:

  1. Onprem, Mongodb:
    modular_service_mode: docker,
    modular_mongo_user: $MONGO_USER,
    modular_mongo_password: $MONGO_PASSWORD,
    modular_mongo_url: $MONGO_URL,
    modular_mongo_db_name: $MONGO_DB_NAME,
    modular_mongo_srv: True, # Optional
    Alternatively, instead of specifying modular_mongo_user, modular_mongo_password,
    modular_mongo_url, and modular_mongo_srv, you can use:
    modular_mongo_uri: $MONGO_URI # Format: mongodb+srv://<USER>:<PASSWORD>@<URL>/
  2. SaaS, DynamoDB (cross-account access):
    modular_service_mode: saas # Optional
    modular_assume_role_arn: $ASSUME_ROLE_ARN
  3. SAAS, DynamoDB (same AWS account):
    modular_service_mode: saas # Optional

Alternatively, you can pass these parameters (fully or partially) on initialization:

from modular_sdk.modular import Modular

modular_sdk = Modular(modular_service_mode='docker',
                      modular_mongo_user='MONGO_USER',
                      modular_mongo_password='MONGO_PASSWORD',
                      modular_mongo_url='MONGO_URL',
                      modular_mongo_db_name='DB_NAME')

# initialize some services
application_service = modular_sdk.application_service()
parent_service = modular_sdk.parent_service()

More examples

Example 1: List Maestro Customers

from modular_sdk.modular import Modular

# initializing application service
customer_service = Modular().customer_service()

# listing available customers 
customers = customer_service.list()

# printing customer names
for customer in customers:
   print(customer.name)

Example 2: Update Maestro Application

from modular_sdk.modular import Modular

# initializing application service
application_service = Modular().application_service()

# extracting application by id
application = application_service.get_application_by_id(
   application_id="$APP_ID")

# updating application description
description_to_set = 'Updated application description'
application_service.update(application=application,
                           description=description_to_set)

# saving updated application
application_service.save(application=application)

Example 3: Delete Maestro Parent

from modular_sdk.modular import Modular

# initializing parent service
parent_service = Modular().parent_service()

# extracting parent by id
parent = parent_service.get_parent_by_id(parent_id="$PARENT_ID")

# deleting parent
parent_service.mark_deleted(parent=parent)

Project links

Data verified by PyPI on Aug 10, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for syndicate.team from gravatar.com syndicate.team

Credits

Author: EPAM Systems

GitHub Statistics

Data verified by PyPI on Aug 10, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache License)

Requires

Python <4, >=3.14

Provides Extra

cryptography jwt hvac test all

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

modular_sdk-8.1.0.tar.gz (84.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

modular_sdk-8.1.0-py3-none-any.whl (104.4 kB view details)

Uploaded Python 3

File details

Details for the file modular_sdk-8.1.0.tar.gz.

File metadata

  • Download URL: modular_sdk-8.1.0.tar.gz
  • Upload date:
  • Size: 84.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for modular_sdk-8.1.0.tar.gz
Algorithm Hash digest
SHA256 8b4ae2dc3a7682fcc15481f0305877cbc3911f0d4ac956e9409f7d8f4a84de31
MD5 5934f8479e00f0243e5a8e967b60a371
BLAKE2b-256 8f3aaffda7e83d4186762a7a6a567d6cb4bc968de99aa7a8973b213df40072de

See more details on using hashes here.

Provenance

The following attestation bundles were made for modular_sdk-8.1.0.tar.gz:

Publisher: pypi-package.yml on epam/modular-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file modular_sdk-8.1.0-py3-none-any.whl.

File metadata

  • Download URL: modular_sdk-8.1.0-py3-none-any.whl
  • Upload date:
  • Size: 104.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for modular_sdk-8.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 98da12ee604c442f995e181dc2ab690ae828e7d05fdca062442e4a9bde934218
MD5 328306a9e0254fb8c687cfa4ced16100
BLAKE2b-256 1ed705622246b06d1b0e3b5e3654749466d052a1d59869684bcdc07aa7f4709f

See more details on using hashes here.

Provenance

The following attestation bundles were made for modular_sdk-8.1.0-py3-none-any.whl:

Publisher: pypi-package.yml on epam/modular-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

8.1.0 This release

2 files

8.0.0

2 files

7.1.11

2 files

7.1.10

2 files

7.1.9

2 files

7.1.8

2 files

7.1.7

2 files

7.1.6

2 files

7.1.5

2 files

7.1.4

2 files

7.1.3

2 files

7.1.2

2 files

7.1.1

2 files

7.1.0

2 files

7.0.0

2 files

Pre-release

7.0.0a0

2 files

6.5.0

2 files

6.4.0

2 files

6.3.2

2 files

6.3.0

2 files

6.2.1

2 files

6.2.0

2 files

6.1.1

2 files

6.1.0

2 files

Pre-release

6.0.1b2

2 files

Pre-release

6.0.1b1

2 files

6.0.0

2 files

5.1.7

2 files

5.1.6

2 files

5.1.5

2 files

5.1.4

2 files

5.1.3

2 files

5.1.2

2 files

5.1.1

2 files

5.1.0

2 files

5.0.2

2 files

5.0.0

2 files

4.0.3

2 files

4.0.2

2 files

4.0.1

2 files

4.0.0

2 files

3.3.11

2 files

3.3.10

2 files

3.3.9

2 files

3.3.8

2 files

3.3.7

2 files

3.3.6

2 files

3.3.5

2 files

3.3.4

2 files

3.3.3

2 files

3.3.2

2 files

3.3.1

2 files

3.3.0

2 files

3.2.0

2 files

3.0.0

2 files

2.2.6

2 files

Pre-release

2.2.6a0

2 files

2.2.5

2 files

2.2.3

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.4

2 files

2.1.3

2 files

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