{"id":6878,"library":"sensai-utils","title":"sensai-utils","description":"sensai-utils is a Python library providing general-purpose utilities extracted from the larger sensAI project. It allows users to leverage various helper functions and classes (e.g., for caching, logging, data structures) without incurring the additional dependencies of the full sensAI library. The current version is 1.6.0, with minor version releases occurring regularly.","status":"active","version":"1.6.0","language":"en","source_language":"en","source_url":"https://github.com/oraios/sensAI-utils","tags":["utilities","sensai","logging","data-structures"],"install":[{"cmd":"pip install sensai-utils","lang":"bash","label":"Install with pip"}],"dependencies":[],"imports":[{"note":"The PyPI package `sensai-utils` exposes its functionality under the `sensai.utils` namespace, not `sensai_utils` directly. Always refer to `sensai.utils`.","wrong":"import sensai_utils.logging","symbol":"configure","correct":"from sensai.utils.logging import configure"},{"note":"Example of importing a utility class for string conversion.","symbol":"ToStringMixin","correct":"from sensai.utils.string import ToStringMixin"}],"quickstart":{"code":"from sensai.utils.logging import configure\nimport logging\nimport os\n\n# Configure a basic logger for demonstration\nlog_file_path = os.path.join(os.getcwd(), 'sensai_utils_quickstart.log')\nconfigure(log_file_path=log_file_path, verbosity=logging.INFO)\n\nlogger = logging.getLogger(__name__)\nlogger.info('sensai-utils logging configured successfully!')\n\nprint(f\"Log messages written to: {log_file_path}\")","lang":"python","description":"This quickstart demonstrates configuring the logging utility from `sensai.utils.logging`. It sets up a basic logger to write informational messages to a file."},"warnings":[{"fix":"Always use `from sensai.utils...` for imports.","message":"The PyPI package name is `sensai-utils`, but the Python import path is `sensai.utils`. Attempting to import `sensai_utils` directly will result in an `ImportError`.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Understand that `sensai-utils` is a standalone utility package; if you need AI-specific features, refer to the `sensAI` library documentation.","message":"`sensai-utils` is a subset of the larger `sensAI` library, specifically designed to be used without `sensAI`'s full set of dependencies. While its utilities are general-purpose, for deep AI-related functionalities, consider installing the full `sensAI` library.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Refer to the `sensAI` project's official documentation for comprehensive details on `sensai.utils` usage.","message":"Documentation for `sensai-utils`'s `util` package is integrated into the main `sensAI` documentation. Users looking for detailed usage examples and API references should consult the `sensAI` documentation for the `util` package.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-15T00:00:00.000Z","next_check":"2026-07-14T00:00:00.000Z","problems":[]}