Configuration

This guide covers various configuration options available in semantic-router.

Logging Configuration

Semantic-router uses Python’s logging module for debugging and monitoring. You can control the verbosity of logs using environment variables.

Setting Log Levels

You can configure the log level in two ways:

Using the semantic-router specific variable (recommended):
export SEMANTIC_ROUTER_LOG_LEVEL=DEBUG
Using the general LOG_LEVEL variable:
export LOG_LEVEL=WARNING

The library checks for SEMANTIC_ROUTER_LOG_LEVEL first, then falls back to LOG_LEVEL. If neither is set, it defaults to INFO.

Available Log Levels

DEBUG: Detailed information for diagnosing problems
INFO: General informational messages (default)
WARNING: Warning messages for potentially problematic situations
ERROR: Error messages for serious problems
CRITICAL: Critical messages for very serious errors

Example Usage

import os
# Set before importing semantic-router
os.environ["SEMANTIC_ROUTER_LOG_LEVEL"] = "DEBUG"

from semantic_router import Route, SemanticRouter
# Your debug logs will now be visible

This is particularly useful when:

Debugging encoder or index issues
Monitoring route matching decisions
Troubleshooting performance problems
Understanding the library’s internal behavior

Get Started

Client Reference

User Guide

Configuration

Configuration

Logging Configuration

Setting Log Levels

Available Log Levels

Example Usage

​Configuration

​Logging Configuration

​Setting Log Levels

​Available Log Levels

​Example Usage

Configuration

Logging Configuration

Setting Log Levels

Available Log Levels

Example Usage