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

# root_settings
       [Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%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%2Fproviders%2Fconfig%2Froot_settings%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[View in Markdown](/codeweaver/api/providers/config/root_settings.md)       [Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F)[Share on X](https://x.com/intent/tweet?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F&text=root_settings)[Share on Threads](https://threads.net/intent/post?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F&text=root_settings)[Share on Bluesky](https://bsky.app/intent/compose?text=root_settings%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F)[Share on Reddit](https://reddit.com/submit?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F&title=root_settings)[Share on Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F&t=root_settings)[Share on Email](mailto:?subject=root_settings&body=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F)[Share on WhatsApp](https://wa.me/?text=root_settings%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F)[Share on Telegram](https://t.me/share/url?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fproviders%2Fconfig%2Froot_settings%2F&text=root_settings)
# `codeweaver.providers.config.root_settings`
[Section titled “codeweaver.providers.config.root_settings”](#codeweaverprovidersconfigroot_settings)
Root settings for provider-only CodeWeaver installation.

This module provides the root settings class when only the providers package is installed (along with core). This enables use of embedding, vector store, and reranking providers without the full CodeWeaver server.

## Class: `CodeWeaverProviderSettings`
[Section titled “Class: CodeWeaverProviderSettings”](#class-codeweaverprovidersettings)
Root settings wrapper for provider-only installation.

When only the providers package is installed (with core), this provides configuration for all provider types: embedding, vector store, reranking, data providers, and agents.

Configuration structure:


**

```
[provider]embedding.provider = "voyage"primary.embedding.model_name = "voyage-code-3"
vector_store.provider = "qdrant"vector_store.url = "http://localhost:6333"
[logging]level = "INFO"
```

Note: This is the root settings class for provider-only installations. When the full server package is installed, CodeWeaverSettings should be used instead, which nests ProviderSettings under the provider field.

## Class: `CodeWeaverProviderSettingsDict`
[Section titled “Class: CodeWeaverProviderSettingsDict”](#class-codeweaverprovidersettingsdict)
TypedDict for CodeWeaver provider settings.