Run/Debug Configurations

[ffinacio]

I am able to run ESP32 micropython statements one by one from main.py (Project.jpg) on RPL with success.
When I try to run the project it fails. I believe the problem is located in the "Run/debug Configurations" panel (RunDebug1.jpg RunDebug2.jpg. Could you give me a help?

[lukaskremla]

Hello,

Your project is misconfigured.

in the root of your project you have the excluded .venv folder. This is a virtual python environment that runs on your computer. If you install Python on your system, it is customary to create virtual environments per-project.

The intent is simple, you don't pollute your main python environment with per-project packages, each project can install different packages (including different versions of packages) and so on.

PyCharm generally creates a new .venv with each new project.

For MicroPython you don't use the .venv directly. Keep it there as it is what makes type hints work. But it doesn't run the actual code.

MicroPython has no concept of .venv, the firmware flashed on the device is itself the environment.

Here are the corrections your setup needs:

Don't manually put items in the .venv and don't use it for MicroPython. Move your main.py from .venv to a folder created in the root of your project - say src.

In the run configuration:

• set local path to the path of the new src folder.
• leave the device path unfilled - it dictates what folder you upload into, not what device you upload to.
• Delete the exclusions you have configured.

If in the future you need exclusions - separate the exclusions so that there's only a single pattern per entry.

Connect to the serial port through the tool window (the one with the file system and REPL tabs) and then run the configuration. It should now work.

[ffinacio]

Hello, Your help is invaluable. Now my project is running perfectly. Thank you very much. Lukas Kremla ***@***.***> escreveu (quinta, 10/09/2026 à(s) 20:25):

…

Hello, Your project is misconfigured. in the root of your project you have the excluded .venv folder. This is a virtual python environment that runs on your computer. If you install Python on your system, it is customary to create virtual environments per-project. The intent is simple, you don't pollute your main python environment with per-project packages, each project can install different packages (including different versions of packages) and so on. PyCharm generally creates a new .venv with each new project. For MicroPython you don't use the .venv directly. Keep it there as it is what makes type hints work. But it doesn't run the actual code. MicroPython has no concept of .venv, the firmware flashed on the device is itself the environment. Here are the corrections your setup needs: Don't manually put items in the .venv and don't use it for MicroPython. Move your main.py from .venv to a folder created in the root of your project - say src. In the run configuration: - set local path to the path of the new src folder. - leave the device path unfilled - it dictates what folder you upload into, not what device you upload to. - Delete the exclusions you have configured. If in the future you need exclusions - separate the exclusions so that there's only a single pattern per entry. Connect to the serial port through the tool window (the one with the file system and REPL tabs) and then run the configuration. It should now work. — Reply to this email directly, view it on GitHub <#102?email_source=notifications&email_token=ACAROQ7FCMLKLUTTBHVYUI35OL52LA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBTHEYTCMZXUZZGKYLTN5XKMYLVORUG64VFMV3GK3TUVRTG633UMVZF6Y3MNFRWW#discussioncomment-18391137>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACAROQ3QDWLGGCPN7HKN5BT5OL52LAVCNFSNUABIKJSXA33TNF2G64TZHM4TAOBVHE2DSNRYHNCGS43DOVZXG2LPNY5TCMBXHEYDKMJUUF3AE> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/ACAROQ4PGX2XG5FNNXKJRHT5OL52LA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBTHEYTCMZXUZZGKYLTN5XKMYLVORUG64VFMV3GK3TUVJTG633UMVZF62LPOM> and Android <https://github.com/notifications/mobile/android/ACAROQ6Y3EDLBRSSSWQRXED5OL52LA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBTHEYTCMZXUZZGKYLTN5XKMYLVORUG64VFMV3GK3TUVZTG633UMVZF6YLOMRZG62LE>. Download it today! You are receiving this because you authored the thread.Message ID: <lukaskremla/micropython-tools-jetbrains/repo-discussions/102/comments/18391137 @github.com>

[lukaskremla]

No problem, happy to have helped.

Feel free to ask again if anything else arises.

[ffinacio]

Fixed! Lukas Kremla ***@***.***> escreveu (domingo, 11/10/2026 à(s) 08:14):

…

Closed #102 <#102> as resolved. — Reply to this email directly, view it on GitHub <#102?email_source=notifications&email_token=ACAROQZQWVCN3ZNGLPNNJTD5TMXN5A5CNFSNUABTM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SFOZSW45B2HJHG65DJMZUWGYLUNFXW4LZSHEYDIMJXGKTHEZLBONXW5JTBOV2GQ33SUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACAROQYWXBVVUAVNOP4WH5D5TMXN5AVCNFSNUABIKJSXA33TNF2G64TZHM4TAOBVHE2DSNRYHNCGS43DOVZXG2LPNY5TCMBXHEYDKMJUUF3AE> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/ACAROQ7OWF7ITZK5OXTABT35TMXN5A5CNFSNUABTM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SFOZSW45B2HJHG65DJMZUWGYLUNFXW4LZSHEYDIMJXGKTHEZLBONXW5JTBOV2GQ33SUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android <https://github.com/notifications/mobile/android/ACAROQ4TV3542PX2RSRDZNL5TMXN5A5CNFSNUABTM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SFOZSW45B2HJHG65DJMZUWGYLUNFXW4LZSHEYDIMJXGKTHEZLBONXW5JTBOV2GQ33SUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you authored the thread.Message ID: <lukaskremla/micropython-tools-jetbrains/repo-discussions/102/discussion_event/2904172 @github.com>