Skip to content

Document the model defaults and overrides the code actually uses - #11

Merged
ethanzhoucool merged 2 commits into
mainfrom
claude/readme-model-defaults
Nov 3, 2026
Merged

ethanzhoucool merged 2 commits into
mainfrom
claude/readme-model-defaults

Conversation

@ethanzhoucool

Copy link
Copy Markdown
Owner

Summary

The README's environment-variable table disagreed with narrate/llm.py:

  • It listed Gemini's model as gemini-2.0-flash. The provider's default is GeminiProvider.DEFAULT_MODEL = "gemini-flash-latest", and its docstring explains why: gemini-2.0-flash was shut down, and that broke v1. So the README pointed readers at the dead model.
  • EMC_ANTHROPIC_MODEL and EMC_GEMINI_MODEL are read by the providers but were not documented.

Changes

  • README.md: corrected the Gemini default, and added rows for the two model overrides. The EMC_GEMINI_MODEL row describes what GeminiProvider.complete does on a 404: it retries once against a current model. enrich() then reports that model as enrichment.model, because it reads provider.model after the call.

Testing

Docs only. I checked each value against explain_my_code/narrate/llm.py: the EMC_ANTHROPIC_MODEL default claude-opus-5, DEFAULT_MODEL, EMC_GEMINI_MODEL, and the 404 retry path in complete().

Notes

The hardcoded test counts (the badge's "145 passing", plus "145 tests" in the layout and testing sections) are already stale: main collects 150 (147 passed, 3 skipped), and the other open PRs add more. I left them for you to update once those PRs land, or to turn into a CI-driven badge.


Generated by Claude Code

claude and others added 2 commits November 2, 2026 07:14
The README listed `gemini-2.0-flash` as the Gemini model. The provider
moved to the `gemini-flash-latest` alias because that pinned model was
shut down, and the README still pointed readers at it. The
EMC_ANTHROPIC_MODEL and EMC_GEMINI_MODEL overrides were not documented.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UigC7feaY8NkAy9oay3GDW
@ethanzhoucool
ethanzhoucool marked this pull request as ready for review November 3, 2026 17:23
@ethanzhoucool
ethanzhoucool merged commit e958219 into main Nov 3, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants