init-pixi-project

To scaffold a Python project using Pixi, you initialize the project directory to generate a standard structure including src/, pyproject.toml, and configuration files. The process automatically installs a standard dependency stack via Pixi to ensure a consistent development environment.

Yes, you can merge Pixi configuration updates into an existing Python project. The process detects existing artifacts like pixi.lock, pixi.toml, or pyproject.toml with [tool.pixi] and explicitly prompts you before merging any changes to ensure safe upgrades.

The standard directory structure for a Pixi-managed Python project includes a clean src/ layout, pyproject.toml or pixi config, and ready-to-use tooling. This scaffolding ensures a consistent development environment with a standard dependency stack installed via Pixi.

Yes, Pixi project initialization supports renaming the project metadata. As part of the post-initialization steps, the process applies optional renaming in the project metadata before running the scaffolding script and installing the standard dependency stack.

If existing Pixi artifacts such as pixi.lock, pixi.toml, or pyproject.toml with [tool.pixi] are detected during initialization, the process pauses and issues explicit user prompts. This ensures you can safely review and approve merging updates into your existing setup before proceeding.