| name | new-python-project |
| description | Scaffold a fresh Python project — folder, virtualenv, .gitignore, README, git init (use when the user wants to start a new Python project) |
| version | 1.0.0 |
| author | 0pen-sourcer |
| tools | ["create_directory","write_file","run_command"] |
New Python project
Set up a clean Python project so the user can start coding immediately.
Inputs
Ask only if not given: the project name and where to create it (default: a Projects or Code folder under the user's home, or the current working directory).
Steps
create_directory <location>/<name>.
write_file these into the project:
README.md — # <name> + a one-line placeholder.
.gitignore — Python defaults: .venv/, __pycache__/, *.pyc, .env, dist/, build/, *.egg-info/.
requirements.txt — empty (or the deps the user named).
main.py — def main():\n ...\n\n\nif __name__ == "__main__":\n main()
run_command in the project dir: create the venv — python -m venv .venv.
run_command: git init (only if git is available; if not, skip and mention it).
- If the user named dependencies, write them to
requirements.txt and run_command the venv pip install (.venv\Scripts\python -m pip install -r requirements.txt).
- Report the path and the exact command to activate the venv (
.venv\Scripts\Activate.ps1 on PowerShell).
Don't
- Don't overwrite an existing folder of the same name — if it exists, ask first.
- Don't install heavy deps the user didn't ask for.
- Keep it minimal; this is a starting point, not a framework.