Declare
State whether AI was used. If it was, list the tools and what each one was used for. Try it:
aidecl.yaml is a small file in your repository. It lists the AI tools that were used, what they were used for and how much of the work they produced, or it states that no AI was used. A named person or team is responsible for it, and your CI validates it like any other file.
pip install aidecl schema_version: "1.0.0"project:name: pySDCcontent_type: softwareai_usage:used: truelevel: moderatecode_proportion:ai_generated_percent: 19ai_assisted_percent: 2human_only_percent: 79declaration:date: "2026-09-28"declared_by: Robert Speck
0% written by hand0% AI-assisted0% AI-generated
These figures come from the declaration published by the pySDC project.
Adopted by
The Netherlands eScience Center's Generative AI Use Policy names the AI Declaration Format as a way to disclose AI use in publicly shared software, publications and datasets.
The pySDC project also publishes an aidecl.yaml in its repository.
Every tool that contributed to the project is recorded in one file. Reviewers, funders, auditors and automated checks all read the same record.
State whether AI was used. If it was, list the tools and what each one was used for. Try it:
Record how much of the work was written by people, written with AI assistance or generated by AI, and how you estimated it.
Figures from the pySDC project, estimated from git blame.
The validator catches mistakes that are easy to miss in review, such as a value the schema does not allow.
✕ aidecl.yaml
Schema error at 'ai_usage.tools.0.hosting':
'cloud' is not valid. Allowed values:
'cloud_vendor', 'cloud_self_hosted',
'on_premise', 'local_offline', 'unknown' Update the declaration with each release and whenever a new tool is introduced. Set a review date, and the validator warns you once it has passed.
Add two steps to a workflow. Validation errors appear as annotations on the pull request.
- run: pip install aidecl
- run: aidecl validate aidecl.yaml \
--output-format github-actions Every declaration names the person or team responsible for it and the date it was made.
A 2026 study examined how 1,000 popular GitHub repositories handle AI-assisted contributions.
0of the 1,000 repositories have a policy on AI contributions
0percent of those policies require contributors to disclose AI use
0percent of those policies require a human in the loop
The declaration is validated in CI alongside the tests.
The AI disclosure a journal asks for, kept alongside the manuscript.
Records how much of the data is synthetic.
Names the base model and the tools used to build on it.
Shows which parts of the analysis were AI-assisted.
States which images, audio or video were AI-generated.
The EU AI Act regulates AI systems. A declaration file does not make a system compliant, and nothing here is legal advice. What the file does is keep information the Act asks for alongside the code.
high_risk, the validator rejects the file until it links to the technical documentation and the declaration of conformity and describes the human oversight measures.$ pip install aidecl $ aidecl init $ aidecl validate aidecl.yaml ✓ aidecl.yaml
Get the command line toolRead the schemaCreate one in the browser