---
title: loader | CodeWeaver Docs
description: API reference for codeweaver.core.config.loader
url: "https://docs.knitli.com/api/core/config/loader"
type: static
generatedAt: "2026-04-17T17:21:07.899Z"
---

# loader
       [Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[View in Markdown](/codeweaver/api/core/config/loader.md)       [Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F)[Share on X](https://x.com/intent/tweet?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F&text=loader)[Share on Threads](https://threads.net/intent/post?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F&text=loader)[Share on Bluesky](https://bsky.app/intent/compose?text=loader%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F)[Share on Reddit](https://reddit.com/submit?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F&title=loader)[Share on Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F&t=loader)[Share on Email](mailto:?subject=loader&body=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F)[Share on WhatsApp](https://wa.me/?text=loader%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F)[Share on Telegram](https://t.me/share/url?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fcore%2Fconfig%2Floader%2F&text=loader)
# `codeweaver.core.config.loader`
[Section titled “codeweaver.core.config.loader”](#codeweavercoreconfigloader)
Configuration loader with automatic package detection.

This module provides utilities for automatically loading the appropriate root settings class based on which CodeWeaver packages are installed.

## Function: `get_settings`
[Section titled “Function: get_settings”](#function-get_settings)

**

```
get_settings()
```

Auto-load the appropriate root settings based on installation.

This function detects which CodeWeaver packages are installed and loads the corresponding root settings class. This allows the same code to work across different installation configurations.

Args: **kwargs: Additional arguments to pass to settings constructor

Returns: The appropriate root settings instance for the current installation

Raises: ImportError: If the detected package’s settings module cannot be imported

Examples:


**

```
# Works with any installationsettings = get_settings()await settings.finalize()
# With custom configsettings = get_settings(config_file="/path/to/config.toml")
```

## Function: `get_settings_async`
[Section titled “Function: get_settings_async”](#function-get_settings_async)

**

```
get_settings_async()
```

Async version of get_settings for use in async contexts.