Struct HematiteConfig 

pub struct HematiteConfig {

    pub mode: PermissionMode,
    pub permissions: Option<PermissionRules>,
    pub trust: WorkspaceTrustConfig,
    pub model: Option<String>,
    pub fast_model: Option<String>,
    pub think_model: Option<String>,
    pub gemma_native_auto: bool,
    pub gemma_native_formatting: bool,
    pub api_url: Option<String>,
    pub voice: Option<String>,
    pub voice_speed: Option<f32>,
    pub voice_volume: Option<f32>,
    pub context_hint: Option<String>,
    pub deno_path: Option<String>,
    pub verify: VerifyProfilesConfig,
    pub hooks: RuntimeHookConfig,
    pub searx_url: Option<String>,
    pub auto_start_searx: bool,
}

Fields

mode: PermissionMode

Active authority mode.

permissions: Option<PermissionRules>

Pattern-based permission overrides.

trust: WorkspaceTrustConfig

Workspace trust policy for the current project root.

model: Option<String>

Override the primary model ID (e.g. “gemma-4-e4b”).

fast_model: Option<String>

Override the fast model ID used for read-only tasks.

think_model: Option<String>

Override the think model ID used for complex tasks.

gemma_native_auto: bool

When true, Gemma 4 models enable native-formatting behavior automatically unless explicitly forced off.

gemma_native_formatting: bool

Force Gemma-native request shaping on for Gemma 4 models.

api_url: Option<String>

Override the LLM provider base URL (e.g. “http://localhost:11434/v1” for Ollama). Defaults to “http://localhost:1234/v1” (LM Studio). Takes precedence over –url CLI flag.

voice: Option<String>

Voice ID for TTS. Use /voice in the TUI to list and select. Defaults to “af_sky”.

voice_speed: Option<f32>

TTS speech speed multiplier. 1.0 = normal, 0.8 = slower, 1.3 = faster. Defaults to 1.0.

voice_volume: Option<f32>

TTS volume. 0.0 = silent, 1.0 = normal, 2.0 = louder. Defaults to 1.0.

context_hint: Option<String>

Extra text appended verbatim to the system prompt (project notes, conventions, etc.).

deno_path: Option<String>

Override path to the Deno executable for the run_code sandbox. If unset, Hematite checks LM Studio’s bundled Deno, then system PATH. Example: “C:/Users/you/.deno/bin/deno.exe”

verify: VerifyProfilesConfig

Per-project verification commands for build/test/lint/fix workflows.

hooks: RuntimeHookConfig

Tool Lifecycle Hooks for automated pre/post scripts.

searx_url: Option<String>

Optional local SearXNG URL (e.g. “http://localhost:8080”) for private research. If set, research_web will prioritize this endpoint over external search proxies.

auto_start_searx: bool

When true, Hematite will attempt to automatically start SearXNG on startup if it’s offline.

Trait Implementations

impl Clone for HematiteConfig

fn clone(&self) -> HematiteConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HematiteConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HematiteConfig

fn default() -> HematiteConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HematiteConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HematiteConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.