AGENTS.md

AGENTS.md

pandas is a BSD-licensed Python library for data analysis, built from Python, Cython, and C/C++ sources with Meson.

Interactions on GitHub

• Never perform issue- or pull-request-related actions on the pandas-dev/pandas GitHub repository on behalf of the user. This includes, but is not limited to, interactions such as pushing code, opening issues or pull requests, and replying to issues, pull requests, or reviews.
• The user is required to disclose your agent information (harness, model, reasoning level), and to mark any verbatim text produced by you (an agent) that they quote with > or a triple-backtick code fence.

The automated contributions policy in contributing.rst defines how the user may use agent-generated work.

Required tooling

This project supports creating a development environment using conda with environment.yml or Pixi with pixi.toml. pandas CI uses Pixi and tasks defined in pixi.toml for all workflows (building pandas, testing, type checking, building documentation, running benchmarks).

Linting checks require pre-commit, installed in a conda or pixi environment, to run checks defined in .pre-commit-config.yaml.

Repository map

• pandas/ — library implementation
• pandas/_libs/ — Cython/C/C++
• pandas/tests/ — test suite
• doc/ — documentation source
• doc/source/whatsnew/ — release notes
• asv_bench/benchmarks/ — benchmarks
• scripts/ — repository checks invoked by pre-commit
• web/ — pandas website
• .github/ — GitHub Actions for CI
• .github/workflows/unit-tests.yml — CI definition for unit tests
• .github/workflows/code-checks.yml — CI definition for doctests, typing validation, benchmark correctness
• .github/workflows/docbuild-and-upload.yml — CI definition for building documentation
• ci/ — CI helpers
• pyproject.toml — project and tooling configurations

References

• contributing.rst — contribution workflow, automated contributions policy
• contributing_environment.rst — development environment instructions
• contributing_codebase.rst — all code standards: pre-commit, backward compatibility, typing, tests, benchmarks
• contributing_documentation.rst — docs structure and building
• policies.rst — versioning and deprecation policy