silasyn-uid 1.0.0

Official zero-dependency Python client for Silasyn UID Studio Pro with automatic offline fallback.

Silasyn UID Studio Pro - Python Client

Official, zero-dependency Python client for generating secure, customizable unique identifiers using the Silasyn UID Studio Pro API.

Features

Zero Dependencies: Built entirely on Python's native standard libraries (urllib, json, uuid, secrets, time). No need to install requests.

Automatic Offline Fallback: If the API endpoint at silasyn.com is unreachable (due to network, firewall, or DNS issues), the client automatically switches to a high-precision local generation engine to guarantee 100% uptime.

Highly Customizable: Supports UUIDv4, UUIDv7 (Time-ordered), NanoID, Hexadecimal, Pure Numeric, and Custom pools with prefixes, suffixes, custom casings, and formatting.

Installation

Install the package from PyPI:

pip install silasyn-uid

Quick Start

from silasyn_uid import UIDStudio

# 1. Generate standard UUIDv4

uuids = UIDStudio.uuid4(count=2)

print(uuids)

# 2. Generate Time-ordered UUIDv7

uuid7s = UIDStudio.uuid7(count=1)

print(uuid7s)

# 3. Generate NanoIDs with a prefix

nanoids = UIDStudio.nanoid(count=3, length=12, prefix="user_")

print(nanoids)

# 4. Generate custom hexadecimal keys

custom_keys = UIDStudio.custom(pool="ABCDEF1234567890", count=2, length=16, hyphens=True)

print(custom_keys)

Configuration Parameters

The core generate method accepts the following arguments:

Parameter

Type

Default

Description

format_type

str

"uuid4"

Options: "uuid4", "uuid7", "nanoid", "hex", "numeric", "custom"

count

int

1

Number of identifiers to generate (Max: 5000)

length

int

21

Overall length of generated string (ignored for UUIDs)

prefix

str

""

Optional string to prepend

suffix

str

""

Optional string to append

hyphens

bool

True

Group characters into blocks separated by hyphens

casing

str

"mixed"

Set character case: "mixed", "lower", "upper"

custom_pool

str

""

Alphanumeric pool used only when format_type="custom"

License

Copyright © 2026 Silasyn. All rights reserved.

Distributed under the MIT License. See LICENSE for details.