​
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:
  1. Using the semantic-router specific variable (recommended): 
    export SEMANTIC_ROUTER_LOG_LEVEL=DEBUG
  2. 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