karpathy/nanoGPT
GitHubThe simplest, fastest repository for training/finetuning medium-sized GPTs.
- Stars:
- 64.5k
- Language:
- Python
- Default branch:
- master
- Last scored:
18.2
Overall
At a glance
- Rank
- #401 of 401
- #56 of 56 Python repos
- Checks passed
- 2 of 17
- Full list below
- Best set up for
- Codex
- Score 19.6
- Needs most work for
- Aider
- Biggest fix: .aider.conf.yml (+14.1 pts)
What it has
What it's missing
What to fix first
Showing fixes for Claude Code
- 1AGENTS.md / CLAUDE.mdAdd an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).+13.2 pts
- 2Test suiteAdd a tests/ (or test/, __tests__/, spec/) directory with runnable tests. Document how to run them in AGENTS.md.+13.2 pts
- 3Reproducible dev envAdd a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.+11.8 pts
Score for each AI agent
Each agent weighs the checks by its own docs. Under each score are its top three. How each agent is scored →
Does karpathy/nanoGPT have agent instructions?
An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.
- AGENTS.md / CLAUDE.md
- None at the root (no AGENTS.md, CLAUDE.md, AGENT.md, .claude/CLAUDE.md or .claude/AGENTS.md)
- Agent-specific files
- None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills
- Repos that have one
- 29 of 56 Python repos · 221 of 401 repos on the leaderboard · See examples →
All 17 checks · 2 passed
✗
Skills (.agents/skills)· 0% pass
No .agents/skills/<name>/SKILL.md
✗
AGENTS.md / CLAUDE.md· 0% pass
No agent instructions file found
✗
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
✗
CI configuration· 0% pass
No CI config found
✗
CONTRIBUTING guide· 0% pass
No CONTRIBUTING file
✗
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
✗
Dependency manifest· 0% pass
No dependency manifest found
✗
Reproducible dev env· 0% pass
No Makefile / devcontainer / Docker / equivalent found
✗
GEMINI.md· 0% pass
No GEMINI.md at repo root
✓
✗
Linter / formatter config· 0% pass
No linter/formatter config found
✗
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
✗
Pre-commit / git hooks· 0% pass
No pre-commit / husky / lefthook found
~
Manageable size· 90% pass
24 files — very small
✗
Test suite· 0% pass
No test directory or test files found
✗
Type configuration· 0% pass
No type config found
How karpathy/nanoGPT compares
- vs leaderboard average
- 48.6 pts below
- Average 66.8
- vs Python average
- 52.8 pts below
- Average 71.0
- Stars among Python repos
- #20 of 56
Missing here, and how many repos have it
- CI configuration · passed by 96% of leaderboard repos, 95% of Python repos
- Dependency manifest · passed by 92% of leaderboard repos, 89% of Python repos
- CONTRIBUTING guide · passed by 86% of leaderboard repos, 88% of Python repos
One fix for the most agents: Test suite would raise the score for all 9 agents, by up to 14.1 points.
Similar repos
Same language and host as this repo, closest in overall score.
- numpy/numpy53.1Python · 33.3k ★
- Python · 38.4k ★
- Python · 187.9k ★
- Python · 149k ★
- Python · 60.2k ★
- microsoft/AI23.2Python · 2.9k ★
Add a badge to your README
Paste this at the top of the README. It shows the score, and links back to this page.
[](https://agentfriendlycode.com/repo/github/karpathy/nanoGPT)Check the score on every pull request
A GitHub Action posts one comment per pull request with how the score changed and why.