Skip to content

docs: document --use-cog-base-image and prebuilt base images#3088

Open
anish-sahoo wants to merge 8 commits into
mainfrom
issue-1820
Open

docs: document --use-cog-base-image and prebuilt base images#3088
anish-sahoo wants to merge 8 commits into
mainfrom
issue-1820

Conversation

@anish-sahoo

Copy link
Copy Markdown
Member

Closes #1820

Summary

  • Add new docs/base-images.md page explaining what Cog prebuilt base images are, what's on them, and how to use/disable --use-cog-base-image
  • Clarify the relationship between --use-cog-base-image and --use-cuda-base-image (mutually exclusive; cuda flag only takes effect when cog base image is disabled)
  • Update docs/getting-started.md and docs/getting-started-own-model.md with notes about default base-image behavior and links to the new page
  • Regenerate docs/llms.txt

Validation

  • prettier --check passes on all changed files
  • mise run docs:llm succeeds
  • docs/cli.md unchanged (already in sync)

@anish-sahoo anish-sahoo requested a review from a team as a code owner July 1, 2026 23:12

@ask-bonk ask-bonk Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm Bonk, and I've done a quick review of your PR.

This PR adds clear documentation for Cog's prebuilt base images and how the --use-cog-base-image / --use-cuda-base-image flags interact. Overall the content is accurate and well-placed.

One issue found:

  1. docs/llms.txt is missing the new base-images.md content — The generation script (mise run docs:llm) uses git ls-files to discover docs, so if it was run before base-images.md was tracked by git, the new page won't be included. The current llms.txt only shows the +7 lines from the getting-started guides, but is missing the ~70 lines of new base-images content. Please regenerate it after ensuring base-images.md is staged/committed.

@ask-bonk

ask-bonk Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Done — posted a review on PR #3088 noting that docs/llms.txt is missing the new base-images.md content and needs to be regenerated.

github run

@ask-bonk

ask-bonk Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

LGTM

github run

anish-sahoo and others added 5 commits July 1, 2026 18:32
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
Signed-off-by: Anish Sahoo <anishsahoo2005@gmail.com>
Merge from #3089 introduced a duplicate TestConcurrentDecoratorIgnoredWhenNotFromCog
function signature that caused a syntax error.
@ask-bonk

ask-bonk Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

LGTM

github run

@ask-bonk

ask-bonk Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

LGTM

github run

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.

Document --use-cog-base-image

1 participant