Windows Terminal Encoding

Fix UnicodeEncodeError on Windows CMD/PowerShell and get full Rich output

On Windows, PraisonAI automatically reconfigures sys.stdout / sys.stderr of the Typer process to UTF-8 before any command runs, and falls back to ASCII glyphs for any output path that still needs it — Rich-heavy commands like praisonai browser doctor work without $env:PYTHONIOENCODING='utf-8'.

from praisonaiagents import Agent

agent = Agent(name="windows-agent", instructions="Handle Unicode output on Windows terminals.")
agent.start("Display this response with proper Unicode encoding on Windows.")

The user sends Unicode text; PraisonAI renders safely without crashing legacy Windows consoles.

Detection Flow

Two-Layer Mitigation

Every Typer command passes through two layers on Windows, so Unicode output never crashes the CLI.

What Runs on Every Typer Invocation

_ensure_utf8_stdio() behaviour:

Quick Start

1. Automatic Handling

   PraisonAI reconfigures stdout/stderr to UTF-8 on Windows and renders Unicode output without crashes:

   praisonai browser doctor

   No configuration needed — no PYTHONIOENCODING workaround required.

2. Legacy Workaround (Older Releases)

   Releases older than PraisonAI PR #5857 only set PYTHONIOENCODING for child processes. On those versions, enable UTF-8 manually (or run pip install --upgrade praisonai):

   $env:PYTHONIOENCODING='utf-8'
   chcp 65001
   praisonai --help

   set PYTHONIOENCODING=utf-8
   chcp 65001
   praisonai --help

How It Works

Configuration Options

The automatic encoding detection requires no configuration. However, you can override behavior:

Common Patterns

Problem: UnicodeEncodeError in Older Versions

Symptom:

UnicodeEncodeError: 'charmap' codec can't encode character '\u2500' in position 0

Solution:

# Temporary fix
set PYTHONIOENCODING=utf-8
praisonai --help

# Or upgrade to latest version
pip install --upgrade praisonai

Pattern: Permanent UTF-8 Setup

For PowerShell users:

# Add to PowerShell profile
Add-Content $PROFILE '$env:PYTHONIOENCODING="utf-8"'

For CMD users:

# Set system environment variable
setx PYTHONIOENCODING utf-8

Pattern: Windows Terminal Integration

Use Windows Terminal instead of legacy CMD:

// Windows Terminal settings.json
{
  "profiles": {
    "defaults": {
      "font": {
        "face": "Cascadia Code"
      }
    }
  }
}

Pattern: Training summary on cp1252

praisonai-train agents handles cp1252/ASCII automatically — the summary table swaps emoji for ASCII (PASSED / *) and falls back to plain-text rows if Rich itself can’t encode. See praisonai-train Package → Windows & non-UTF-8 Consoles for the full flow.

Best Practices

Related