Agent Friendly Code
← back to leaderboard

python/cpythonGitHub

https://github.com/python/cpython
Stars:
77.6k
Language:
Python
Default branch:
main
Last scored:
6h ago
Overall

At a glance

Rank
#259 of 371
#47 of 57 Python repos
Checks passed
6 of 16
Full list below
Best set up for
GPT-5 Codex + 1 more
Score 67.6
Needs most work for
Cursor
Biggest fix: Cursor rules (.cursor/rules) (+12.0 pts)

What it has

  • CI configuration
  • CONTRIBUTING guide
  • License file
  • Linter / formatter config
  • Pre-commit / git hooks

What it's missing

  • .aider.conf.yml
  • Cursor rules (.cursor/rules)
  • Dependency manifest
  • GEMINI.md
  • .openhands/setup.sh

What to fix first

  1. 1
    Dependency manifest
    Commit a proper manifest (package.json, pyproject.toml, Cargo.toml, go.mod, etc.) plus a lockfile.
    +9.2 pts
  2. 2
    Type configuration
    Add a type config (tsconfig.json for JS/TS, mypy.ini or pyrightconfig.json for Python). Rust/Go/JVM/Scala/Swift/C#/OCaml/Haskell/Zig are typed by default.
    +7.9 pts
  3. 3
    Manageable size
    If possible, split into smaller modules or carve out a focused entry path. Document where to start in AGENTS.md.
    +5.3 pts

Score for each AI agent

Each agent looks for different things in a repo, based on its own docs. Under each score are the three checks it cares about most.

GPT-5 Codex
67.6
Kimi CLI
67.6
Claude Code
67.5
Pi
66.9
Devin
66.6
OpenHands
61.1
Gemini CLI
57.7
Aider
57.3
Cursor
56.1

Similar repos

Scored for Claude Code. Same language and host as this repo, scoring near it.

All Python repos →

All checks

AGENTS.md / CLAUDE.md· 80% pass
File exists (602 chars)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
23 GitHub Actions workflow(s)
.github/workflows
CONTRIBUTING guide· 100% pass
Guide present
.github/CONTRIBUTING.rst
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 0% pass
No dependency manifest found
Reproducible dev env· 70% pass
Has .devcontainer/devcontainer.json
.devcontainer/devcontainer.json
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 100% pass
Config detected
.ruff.toml
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 100% pass
Hook framework configured
.pre-commit-config.yaml
README· 100% pass
README detailed (8906 chars)
README.rst
Manageable size· 20% pass
6419+ files — very large
Test suite· 70% pass
Test files detected (Lib/idlelib/idle_test/test_autocomplete.py)
Lib/idlelib/idle_test/test_autocomplete.py
Type configuration· 0% pass
No type config found

Add a badge to your README

Paste this at the top of the README. It shows the score, and links back to this page.

Agent friendly score for github/python/cpython
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/python/cpython.svg)](https://agentfriendlycode.com/repo/github/python/cpython)

Check the score on every pull request

Add this file to your repo. On each pull request, it posts one comment showing how the score changed and why. It runs in your own CI, with no outside server involved.

# .github/workflows/agent-friendly.yml
name: Agent-friendly score diff

on:
  pull_request:
    branches: [main]

permissions:
  contents: read
  pull-requests: write

jobs:
  score-diff:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with:
          fetch-depth: 0
      - uses: hsnice16/agent-friendly-action@v0
        with:
          agents-badge-token: ${{ secrets.AGENTS_BADGE_TOKEN }}

Add AGENTS_BADGE_TOKENto the repo's secrets to turn the comment on. Without it, the action does nothing. Where do I add it?