Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Python sample Playground debugging uses Windows-only paths and PowerShell command on macOS

Open
#271 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
78/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
powershell, python, vscode
Domain
developer-experience, tooling

Research direction

In the sample-agent VS Code configuration, inspect settings.json, launch.json, and tasks.json first. Compare the Python interpreter, Playground PATH, and token-refresh command settings with the documented macOS workflow, then run the VS Code configuration checks. Done means the Playground debug workflow works on macOS while retaining the Windows defaults.

Written by the indexing model from the issue text.

Description

Description:

Summary

The README includes macOS environment setup, but the sample’s VS Code F5 configuration contains Windows-specific interpreter paths, a Windows PATH separator, and a PowerShell executable name unavailable on Mac.

Sample: https://github.com/microsoft/Agent365-Samples/tree/main/python/agent-framework/sample-agent

Environment

macOS on Apple Silicon, Python 3.11.15, PowerShell 7.6.0 installed as pwsh.

Steps to Reproduce

Create the documented virtual environment on macOS, install PowerShell, and select Debug in Microsoft 365 Agents Playground in VS Code. The configuration references these incompatible values:

Location Configured Value macOS Equivalent
settings.json .venv/Scripts/python.exe python
launch.json, Python launch .venv/Scripts/python.exe python
launch.json, Playground PATH ; separator : separator
tasks.json, token refresh powershell pwsh
Expected Behavior

The documented Playground debug workflow should resolve the correct interpreter and executables on macOS without manual configuration changes.

Suggested Resolution

Use portable interpreter discovery and platform-specific overrides for the Python launch, Playground PATH, and token-refresh task. I applied macOS overrides locally while retaining the Windows defaults; VS Code configuration checks pass.

Dominant language
Python
Stars
41
Forks
23
Avg merge
7h 43m
Merged PRs (30d)
3

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/Agent365-python

All issues in microsoft/Agent365-python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.