Skip to content

🟠 Verify Workflow: Set Up Project

Verify that your Python Project is correctly set up and aligned with VS Code.

1. Use Machine Terminal to Open Project with code .

On your machine:

  1. Open a machine terminal.
  2. Navigate to your Repos folder.
  3. Change directory (cd) into your project repository folder.
  4. Close VS Code if it is open.
  5. Open the project using:
code .

2. Verify uv and Python Environment

Open the VS Code terminal and run the following commands one at a time:

uv --version
uv run python --version

Verify

  • uv --version prints a version number
  • uv run python --version prints the Python version pinned for this project
  • No error messages appear

3. Verify Virtual Environment

Look at the VS Code Explorer (left panel). Verify:

  • a .venv/ folder exists in the project root
  • pyproject.toml exists in the project root
  • .python-version exists

Click on a Python file (look in the src folder)

  • Look at the right side of the VS Code status bar at the bottom of the window.
  • Verify that VS Code shows .venv as the selected Python interpreter.
If the interpreter is not correct:
  • Open the Command Palette (with "View" / "Command Palette")
  • Select Python: Select Interpreter
  • Choose the interpreter inside this project's .venv folder
  • Reload VS Code (Developer: Reload Window)

Final Checklist

Your project setup is complete when all are true:

  • [ ] VS Code was opened using code .
  • [ ] VS Code Terminal opens in the project root folder
  • [ ] .venv/ exists in the project
  • [ ] uv run python --version works
  • [ ] the project .venv appears in the bottom status bar when a .py file is selected

Congratulations - your project environment is ready for work!

◄ Back to 🟠 Workflow C