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

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

This module provides the root settings class when only the engine package is installed (along with core and providers). This enables use of indexing and chunking functionality without the full CodeWeaver server.

## Class: `CodeWeaverEngineSettings`
[Section titled “Class: CodeWeaverEngineSettings”](#class-codeweaverenginesettings)
Root settings wrapper for engine-only installation.

When only the engine package is installed (with core and providers), this provides configuration for indexing and chunking operations. The config structure is identical to CodeWeaverSettings, but without server-specific settings.

Configuration structure:


**

```
[indexer]batch_size = 100parallel_workers = 4
[chunker]max_chunk_size = 1000overlap = 200
[provider]embedding.provider = "voyage"embedding.model_name = "voyage-code-3"
[logging]level = "INFO"
```

Note: This is the root settings class for engine-only installations. When the full server package is installed, CodeWeaverSettings should be used instead, which nests IndexerSettings and ChunkerSettings under their respective fields.