(root)

The root directory contains project-level configuration files and metadata that govern packaging, dependencies, and development workflows.

Purpose

These files define how the project is built, installed, and configured. They are the entry point for any developer setting up the project for the first time.

Typical Contents

• pyproject.toml — Project metadata, dependencies, build configuration, and tool settings (pytest, linting, etc.). This is the primary packaging descriptor for the Python project.
• README.md — Project documentation, installation instructions, and usage examples.
• Configuration files — Any additional dotfiles or config for CI/CD, linting, formatting, or editor integration.

The root directory acts as the glue that ties together the src/, tests/, benchmarks/, and cli/ directories into a cohesive, installable Python package.