__init__.py

Go to the documentation of this file.

# Copyright (c) 2025-present Aquin Labs Private Limited. All Rights Reserved.
# This file is part of the Aquin Engine. Unauthorized copying, modification,
# distribution, or use of this file, via any medium, is strictly prohibited.
# Proprietary and confidential. See LICENSE for terms.
 
"""Aquin Python package — SDK + CLI.
 
Import stays light so ``python -m aquin`` / install probes do not pull torch.
 
Training recorder::
 
    from aquin import init, Run
 
Full framework SDK (same capabilities as the CLI)::
 
    from aquin import sdk
    sdk.session.load_model("meta-llama/Llama-3.2-1B-Instruct")
    sdk.eval.custom(...)
    sdk.inspect.trace(prompt="...", layer=8)
"""
 
from __future__ import annotations
 
from typing import Any
 
__all__ = [
    "Run",
    "init",
    "AccessDeniedError",
    "sdk",
    "AquinError",
]
 
 
class AccessDeniedError(Exception):
    pass
 
 
def __getattr__(name: str) -> Any:
    if name in ("Run", "init"):
        from aquin.run import Run, init
 
        return Run if name == "Run" else init
    if name == "sdk":
        import aquin.sdk as sdk_pkg
 
        return sdk_pkg
    if name == "AquinError":
        from aquin.sdk._runtime import AquinError
 
        return AquinError
    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")