karpathy/nanochat

At a glance

Rank

#392 of 401

#54 of 56 Python repos

Checks passed

5 of 17

Full list below

Best set up for

Claude Code

Score 42.1

Needs most work for

Cursor

Biggest fix: Cursor rules (.cursor/rules) (+11.5 pts)

What to fix first

Showing fixes for Claude Code

1. 1
   AGENTS.md / CLAUDE.md

   Add an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).
   +13.2 pts
2. 2
   Reproducible dev env

   Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
   +11.8 pts
3. 3
   Linter / formatter config

   Configure a linter/formatter (ESLint+Prettier, Biome, Ruff, rustfmt+clippy, golangci-lint) and commit the config.
   +7.9 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/nanochat 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 →

# AGENTS.md

Guidance for AI coding agents working in karpathy/nanochat. The best ChatGPT that $100 can buy. Written mainly in Python.

## Where things are

- Dependencies are declared in `pyproject.toml`.
- Tests live in `tests`.

## Commands

<!-- Fill in the exact commands CI runs. -->
- Install: TODO
- Test: TODO
- Lint: TODO

How karpathy/nanochat compares

vs leaderboard average

27.5 pts below

Average 66.8

vs Python average

31.7 pts below

Average 71.0

Stars among Python repos

#23 of 56

One fix for the most agents: Linter / formatter config 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.

• AUTOMATIC1111/stable-diffusion-webui54.5
  Python · 165.2k ★
• numpy/numpy53.1
  Python · 33.3k ★
• sgl-project/sglang51.5
  Python · 38.4k ★
• Significant-Gravitas/AutoGPT51.3
  Python · 187.9k ★
• langchain-ai/langchain50.7
  Python · 149k ★
• microsoft/AI23.2
  Python · 2.9k ★