Documentation Suggestion: Add Windows Encoding Note for LiteLLM #163
Description
Documentation Suggestion: Add Windows Encoding Note for LiteLLM
Location: https://google.github.io/adk-docs/agents/models/
Description:
When using ADK agents with LiteLlm on Windows, users might encounter a UnicodeDecodeError: 'charmap' codec can't decode byte... error. This often happens when litellm (used by LiteLlm) tries to read cached files (like model pricing information) using the default Windows encoding (cp1252) instead of UTF-8.
Suggested Improvement:
Add a note to the documentation, specifically on the Models page or where LiteLlm is discussed, recommending that Windows users set the PYTHONUTF8 environment variable to 1. This forces Python to use UTF-8 globally and can prevent this decoding error.
Example (PowerShell):
# Set for current session
$env:PYTHONUTF8 = "1"
# Set persistently for the user
[System.Environment]::SetEnvironmentVariable('PYTHONUTF8', '1', [System.EnvironmentVariableTarget]::User)