Check calendars, find open times, and manage Google Calendar events with confirmation before every change.
by Jay81 installs33 stars
Coding
Python Assistant
Set up, inspect, and repair project-local Python environments with reproducible, low-risk commands.
What it does
Set up and troubleshoot reproducible Python project environments with project-local virtual environments and interpreter-aware pip commands. The workflow inspects dependency files, diagnoses the active Python executable, bootstraps or recreates `.venv`, installs requirements or editable packages, and runs tests and tools through the venv. Safety defaults avoid global installs and unapproved setup hooks.
When to use it
- Bootstrapping a `.venv` from requirements
- Installing a `pyproject.toml` package in editable mode
- Recreating a corrupted virtual environment
- Diagnosing interpreter and dependency errors
The skill document
Python
Use this skill to keep Python workflows reproducible and low-risk across local/dev shells.
Safety Defaults
- Prefer project-local virtual environments (
.venv) over global installs. - Prefer
python3 -m pip ...to avoid interpreter and pip mismatch. - Inspect dependency files before install (
requirements*.txt,pyproject.toml). - Avoid executing unknown setup hooks or random install scripts without user approval.
Standard Workflow
- Detect current environment:
python3 --version
python3 -c "import sys; print(sys.executable)"
{baseDir}/scripts/python_env_tool.py doctor
- Create or refresh a venv:
{baseDir}/scripts/python_env_tool.py bootstrap --venv .venv --requirements requirements.txt
- Install project package (if
pyproject.tomlexists):
{baseDir}/scripts/python_env_tool.py install --venv .venv --editable
- Run tests/tools from the venv interpreter:
.venv/bin/python -m pytest -q
.venv/bin/python -m pip list --outdated
Task Recipes
# Install specific packages into venv
{baseDir}/scripts/python_env_tool.py install --venv .venv --package requests --package pydantic
# Install from requirements file
{baseDir}/scripts/python_env_tool.py install --venv .venv --requirements requirements-dev.txt
# Recreate corrupted venv from scratch
{baseDir}/scripts/python_env_tool.py bootstrap --venv .venv --recreate --requirements requirements.txt
Troubleshooting Rules
ModuleNotFoundError: verify command is run via.venv/bin/python, then reinstall deps.externally-managed-environment: stop global install attempts; use venv.- Build failures on native deps: upgrade
pip setuptools wheel, then retry. - Multiple Python versions: always print and confirm
sys.executablebefore fixes.
Bundled Helper
Use the helper for repeatable environment setup and diagnosis:
{baseDir}/scripts/python_env_tool.py --help
{baseDir}/scripts/python_env_tool.py doctor
Questions people ask
- Can it create or repair a project virtual environment?
- Yes. The bundled helper can bootstrap `.venv` from a requirements file or recreate a corrupted environment from scratch.
- How does it prevent pip from using the wrong Python interpreter?
- It prefers `python3 -m pip`, prints `sys.executable`, and runs project commands through `.venv/bin/python`.
- What Python environment problems does it help diagnose?
- It provides rules for `ModuleNotFoundError`, externally managed environments, native dependency build failures, and projects with multiple Python versions.
Related skills
Save, search, organize, and manage Get Notes content and knowledge bases through explicit commands.
755 installs66 stars
Build and operate a testable learning plan with practice, spaced review, transfer checks, and durable local records.
by Iván93 installs3 stars
Learn a topic through level checks, adaptive explanations, retrieval practice, and review across sessions.
270 installs8 stars
Discover and trade Polymarket crypto fast markets using CEX momentum or a custom signal.
262 installs50 stars
Extract email dates, links, and deadlines for review, then create or update tracked Google Calendar events.
236 installs5 stars