# utils

Python API: `luxonis_ml.utils`

Shared utility entry point for Luxonis ML internals and integrations.

The luxonis_ml.utils package gathers cross-cutting helpers used throughout the data, tracker, telemetry, and archive modules. It
includes configuration loading, environment-backed settings, a local/remote filesystem abstraction, graph traversal helpers,
logging/deprecation utilities, and registry primitives for plugin-style extension points.

> **Example**
> Access the shared filesystem abstraction from the package import.

```python
from luxonis_ml.utils import LuxonisFileSystem

fs = LuxonisFileSystem("file:///tmp/dataset")
files = fs.walk_dir(".")
```

> **Note**
> Some utilities rely on optional dependencies. Install `luxonis-ml[utils]` when using filesystem, config, and logging helpers outside environments that already provide those packages.

> **See Also**
> [luxonis_ml.utils.config](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/config.md), [luxonis_ml.utils.environ](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/environ.md), [luxonis_ml.utils.filesystem](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/filesystem.md), and [luxonis_ml.utils.registry](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/registry.md) for the implementation-level contracts.

## Child Pages

 * [Filesystem
   CLI](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/__main__.md)
 * [config](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/config.md)
 * [environ](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/environ.md)
 * [filesystem](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/filesystem.md)
 * [graph](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/graph.md)
 * [logging](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/logging.md)
 * [path](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/path.md)
 * [registry](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/utils/registry.md)