Skip to content

docs(WIP): update /ai structure, add Docker Model Runner#574

Draft
KiKaraage wants to merge 22 commits into
projectbluefin:mainfrom
KiKaraage:main
Draft

docs(WIP): update /ai structure, add Docker Model Runner#574
KiKaraage wants to merge 22 commits into
projectbluefin:mainfrom
KiKaraage:main

Conversation

@KiKaraage
Copy link
Copy Markdown

  • Add LM Studio, Goose Desktop, OpenCode Desktop, Newelle (WIP)
  • Add informations for Docker Model Runner
  • Clarify structure: Promote local LLM usage > List installable CLI tools > List desktop apps facilitating local & cloud providers
  • Update model examples (Dec '25)

- Add LM Studio, Goose Desktop, OpenCode Desktop, Newelle (WIP)
- Add informations for Docker Model Runner
- Clarify structure: Promote local LLM usage > List installable CLI
tools > List desktop apps facilitating local & cloud providers
- Update model examples (Dec '25)
@KiKaraage
Copy link
Copy Markdown
Author

Heads up, I will need help with screenshots of LM Studio + Goose (I think I got this one covered thanks to Jorge's masto) + OpenCode casks!

@inffy
Copy link
Copy Markdown
Member

inffy commented Jan 15, 2026

Here is one for LM Studio
image

KiKaraage and others added 19 commits January 19, 2026 11:47
Co-authored-by: KiKaraage <10529881+KiKaraage@users.noreply.github.com>
convert to descriptive paragraphs, list AAIF involvement + brief
tools/extension info + recipes & scheduler
docs(reports): Monthly report for March 2026
docs(reports): Monthly report for March 2026
docs(reports): Monthly report for March 2026
docs(reports): Monthly report for March 2026
docs(reports): Monthly report for April 2026
@kubestellar-hive
Copy link
Copy Markdown
Contributor

Hi @KiKaraage — this PR has a merge conflict with main. When you get a chance, could you rebase it? Happy to review once it's conflict-free. 🙏

@kubestellar-hive
Copy link
Copy Markdown
Contributor

Hey @KiKaraage, this has been open for a while — any update on the WIP sections? Happy to review and merge once it's ready. Let us know if you need any guidance on the Docker Model Runner or LM Studio sections.

@kubestellar-hive
Copy link
Copy Markdown
Contributor

CI review (ci-maintainer): no CI checks on this branch

PR is marked WIP in title. Content changes look reasonable (LM Studio, Goose Desktop, Docker Model Runner docs + two monthly reports). No structural issues. No CI configured for documentation branches — manual review required before merge.

Copy link
Copy Markdown
Member

@hanthor hanthor left a comment

Choose a reason for hiding this comment

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

The title is marked [WIP] -- please remove the WIP marker and confirm the content is ready for review/merge, or convert to a draft PR until it is. The additions (LM Studio, Docker Model Runner, updated model list) look useful but I cannot approve a PR explicitly marked as work in progress.

Copy link
Copy Markdown
Member

@hanthor hanthor left a comment

Choose a reason for hiding this comment

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

Code Review: PR #574 — update /ai structure, add Docker Model Runner

Issues that must be fixed

1. PR opened from main branch of fork
The PR's head branch is KiKaraage/main. Opening PRs from main is an anti-pattern — any additional commits to the fork's main branch (e.g., syncing with upstream) will pollute this PR. Please recreate from a feature branch:

git checkout -b docs/ai-docker-model-runner
git push origin docs/ai-docker-model-runner

Then close this PR and open a new one from the feature branch.

2. Two large report files (1,264 lines) with no clear relationship to the AI page
reports/2026-02-28-report.mdx (557 lines) and reports/2026-03-31-report.mdx (707 lines) are added but:

  • Not linked from docs/ai.md or any navigation
  • Not referenced in the PR description
  • Are these monthly reports part of this change, or accidentally committed?

Either remove them from this PR, or add navigation links and explain their purpose in the description.

3. Restructured content loses the AI CLI tools table
The comprehensive CLI tools table (16 tools with descriptions) was removed and replaced with bullet points. The table was more scannable and useful for users deciding which tool to install. Consider keeping it.

Suggestions

  • The Docker Model Runner section is well-written and appropriately placed after Ramalama
  • The reorganization (local LLM → AI Lab → Ramalama → Docker Model Runner → existing tools) is logical
  • Consider updating the Ramalama rl pull and rl run examples — nemotron-3-nano is less well-known than the previous llama3.2. If the old model names are deprecated, note why.

Copy link
Copy Markdown
Member

@hanthor hanthor left a comment

Choose a reason for hiding this comment

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

Approved: Reorganizes Bluespeed section in ai.md — consolidates duplicate content, focuses on actionable value props. Docs-only, no code changes.

@hanthor
Copy link
Copy Markdown
Member

hanthor commented Jun 2, 2026

Unblock summary — what's needed to merge

This PR (@KiKaraage) is blocked by changes_requested from @hanthor (2026-05-29) and has been open since January 2026 (~4.5 months without updates). There are structural issues that must be resolved before this can merge.

Critical: PR was opened from main branch of your fork
The head branch is KiKaraage/main. This is an anti-pattern — any syncs of your fork's main with upstream will pollute this PR with unrelated commits. To fix this, the PR needs to be recreated from a feature branch:

git checkout main
git checkout -b docs/ai-docker-model-runner
# cherry-pick your changes if needed
git push origin docs/ai-docker-model-runner

Then close this PR and open a new one from docs/ai-docker-model-runner.

Two large unrelated report files were committed
reports/2026-02-28-report.mdx (557 lines) and reports/2026-03-31-report.mdx (707 lines) are included but:

  • Not linked from docs/ai.md or any navigation
  • Not mentioned in the PR description
    These appear to have been accidentally committed. They must be removed from this PR (or explained and linked if intentional).

WIP marker in title
The title still says [WIP]. @hanthor cannot approve a PR explicitly marked as work in progress. Either remove [WIP] when ready, or convert to a GitHub draft PR.

Secondary concern: CLI tools table was removed
The comprehensive 16-tool CLI table was replaced with bullet points. Consider restoring the table format for scannability.

Action items for @KiKaraage:

  • Recreate this PR from a feature branch (not from main)
  • Remove the two reports/ files that were accidentally committed
  • Remove [WIP] from the title when content is ready for review
  • Confirm you're still actively working on this (last update was January 2026)

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.

3 participants