gogo2/utils/README.md

Utility Scripts

This directory contains utility scripts for managing the trading bot development environment.

Port Management Utility

The port_manager.py script provides utilities for managing ports and killing stale processes:

# Kill all stale debug instances
python utils/port_manager.py --kill-stale

# Free a specific port
python utils/port_manager.py --free-port 6007

# Find an available port in a range
python utils/port_manager.py --find-port --min-port 6000 --max-port 7000

# Try to use a preferred port with fallback
python utils/port_manager.py --preferred-port 6007 --min-port 6000 --max-port 7000

TensorBoard Launcher

The launch_tensorboard.py script launches TensorBoard with automatic port management:

# Launch TensorBoard with default settings
python utils/launch_tensorboard.py

# Launch with custom log directory and port range
python utils/launch_tensorboard.py --logdir=path/to/logs --preferred-port=6007 --port-range=6000-7000

# Launch and kill stale processes first
python utils/launch_tensorboard.py --kill-stale

Integration with VSCode Tasks

These utilities are integrated with VSCode tasks in .vscode/tasks.json:

1. Start TensorBoard: Launches TensorBoard with automatic port management
2. Kill Stale Processes: Kills all stale debug instances

You can run these tasks from the VSCode command palette (Ctrl+Shift+P) by typing "Tasks: Run Task" and selecting the task.

Requirements

These utilities require the psutil package, which is included in the project's requirements.txt file.