talemate/docs/getting-started/advanced/debug-logging.md
veguAI d0ebe95ca6
Some checks failed
ci / container-build (push) Has been cancelled
ci / deploy-docs (push) Has been cancelled
Python Tests / test (3.11) (push) Has been cancelled
0.35.0 (#242)
Major features:
- Autonomous scene direction via director agent (replaces auto-direct)
- Inline image display in scene feed
- Character visuals tab for portrait/cover image management
- Character message avatars with dynamic portrait selection
- Pocket TTS and llama.cpp client support
- Message appearance overhaul with configurable markdown display

Improvements:
- KoboldCpp: adaptive-p, min-p, presence/frequency penalty support
- Setup wizard for initial configuration
- Director chat action toggles
- Visual agent: resolution presets, prompt revision, auto-analysis
- Experimental concurrent requests for hosted LLM clients
- Node editor alignment shortcuts (X/Y) and color picker

Bugfixes:
- Empty response retry loop
- Client system prompt display
- Character detail pins loading
- ComfyUI workflow charset encoding
- Various layout and state issues

Breaking: Removed INSTRUCTOR embeddings
2026-01-27 10:22:41 +02:00

1,022 B

Debug Logging

By default, Talemate logs at the INFO level. To enable more verbose DEBUG logging, set the TALEMATE_DEBUG environment variable to 1 before starting the server.

This will output detailed debug information from all components, which is useful for troubleshooting issues or reporting bugs.

:material-linux: Linux

Prefix the start command with the environment variable:

TALEMATE_DEBUG=1 ./start.sh

Or if running manually:

TALEMATE_DEBUG=1 uv run src/talemate/server/run.py runserver --host 0.0.0.0 --port 5050

:material-microsoft-windows: Windows

Set the environment variable before running the start script:

SET TALEMATE_DEBUG=1
start.bat

Disabling debug logging

To return to normal logging, unset the variable or set it to 0:

:material-linux: Linux

unset TALEMATE_DEBUG

Or simply run without the prefix:

./start.sh

:material-microsoft-windows: Windows

SET TALEMATE_DEBUG=0
start.bat