Set up a Python environment inside the project and install its packages. Follow existing environment tools when present, avoid changing the system Python, and provide commands that work from a fresh shell.
中文简介正在准备中。当前显示英语简介。
Setting up or installing into a Python environment. One rule applies whether or not you read the body - the environment belongs with the project, so create it inside the project directory (.venv) or let uv manage it, and never in a scratch directory like /tmp and never by forcing an install into the system interpreter. Load the body before creating a virtualenv, choosing an installer, or writing run instructions for a Python project.
安装前可以查看交给 AI 代理的指令内容。
The environment is part of the project, not scratch space. A user who opens the project tomorrow, or clones it on another machine, should find the environment where their editor, their tooling, and their habits expect it.
Create it inside the project directory — .venv at the project root is the
convention nearly every editor and tool auto-detects:
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
For a greenfield project, prefer uv, which manages a project-local .venv for
you and is much faster:
uv venv
uv pip install -e . # or `uv sync` when there is a lockfile
uv run python -m yourpkg # runs in the project env without activating
Never put the environment in /tmp, ~/envs, or any other scratch location
outside the project. It is invisible to the user's tooling, it is not what they
will look for, and on /tmp it is deleted out from under them.
Homebrew, Debian, and Ubuntu mark the system interpreter as externally managed,
so pip install outside a virtualenv refuses with:
error: externally-managed-environment
That is the signal to create the project environment — not an obstacle to work
around. Do not pass --break-system-packages, set
PIP_BREAK_SYSTEM_PACKAGES, or delete the EXTERNALLY-MANAGED marker: those
mutate an interpreter the OS owns, leave the project with no environment of its
own, and can break other software on the machine.
Write the run instructions against the project environment, so they work from a fresh shell in the project directory:
source .venv/bin/activate
python -m yourpkg ...
or, with uv, uv run python -m yourpkg ....
Do not hand back absolute paths into an environment outside the project
(/tmp/whatever/bin/python -m yourpkg). Even when they work right now, they
tell the user their project has no environment of its own.
If the project already has an environment or a declared tool — a .venv, a
uv.lock, Poetry, Pipenv, conda — use it rather than introducing a second one.
Check before creating.
还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Create a 3D object with three.js, inspect it from every angle in an interactive viewer, and download it as OBJ + MTL or GLB for use in other 3D applications.
中文简介正在准备中。当前显示英语简介。
Maintain a private task list with deadlines, next steps, waiting parties, and blockers. Update progress and dependencies, merge duplicate items, and archive closed tasks so ongoing commitments stay clear and easy to follow.
中文简介正在准备中。当前显示英语简介。
Coordinate a task from a verifiable goal through completion. Handle work directly or split independent tasks across separate agent sessions, track progress, verify results, and arrange pull request merging when included in the goal.
中文简介正在准备中。当前显示英语简介。
Create animated HTML pages with smooth scene transitions and playback controls. An editable timeline lets users adjust scene lengths and speeds, with fixed landscape or portrait layouts prepared for video export.
中文简介正在准备中。当前显示英语简介。
Review synced Apple Health records, including steps, heart rate, sleep, and workouts. Retrieve daily summaries or detailed samples for a chosen period, and check sync status and missing data before interpreting the results.
中文简介正在准备中。当前显示英语简介。
Create and edit Word documents and templates, reorganize text, replace images, and work with tracked changes or comments. Apply proper headings and lists, then render every page to check its appearance before delivery.
中文简介正在准备中。当前显示英语简介。