ollama - ๐Ÿ’ก(How to fix) Fix docs: update stale README docs

Official PRs (โ€ฆ)
ON THIS PAGE

Recommended Tools

ร—6

Utilities matched from this issueโ€™s tags and category โ€” try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful ยท Quick feedback

Loadingโ€ฆ

Error Message

3. Anthropic streaming docs list unsupported ping / error events as supported

The compatibility docs mark ping and error stream events as supported:

Code Example

client.webSearch({ query: "what is ollama?" })                                                                                                                                                                                                                                                                                                                   
   client.webFetch({ url: "https://ollama.com" })

---

@mariozechner/pi-coding-agent

---

@earendil-works/pi-coding-agent

---
RAW_BUFFERClick to expand / collapse

What is the issue?

I found five areas for documentation improvements

1. Some llama.cpp links still point to the old ggerganov/llama.cpp repo

Several README/source-comment references still use the old GitHub owner:

https://github.com/ollama/ollama/blob/f63eea3d273816ffc27fbeb0662ab44d236abc45/llama/README.md#L3-L7

But the project now lives under ggml-org/llama.cpp. https://github.com/ollama/ollama/commit/e840ccb5239c92f5f118fbdcb3288f844c4a9f8d changed one but not all of the existing links.

2. Web search JavaScript examples pass strings, but ollama-js expects request objects

The docs show string arguments:

https://github.com/ollama/ollama/blob/f63eea3d273816ffc27fbeb0662ab44d236abc45/docs/capabilities/web-search.mdx#L113
https://github.com/ollama/ollama/blob/f63eea3d273816ffc27fbeb0662ab44d236abc45/docs/capabilities/web-search.mdx#L216

But the published JS SDK expects request objects:

https://github.com/ollama/ollama-js/blob/9c92b18d4026/src/browser.ts#L348-L369

So these should be:

client.webSearch({ query: "what is ollama?" })                                                                                                                                                                                                                                                                                                                   
client.webFetch({ url: "https://ollama.com" })

This is actually introduced by https://github.com/ollama/ollama/commit/7d411a468671ae59c1e5a32701f6ad1d735b12c0 . @ParthSareen could you kindly explain the reason you thought this was correct? I tried to reproduce both behavior and found the change by the commit to lead to errors. Minimal poc: https://gist.github.com/doehyunbaek/f93f265eaf57de1b20a8d1e684293e06

3. Anthropic streaming docs list unsupported ping / error events as supported

The compatibility docs mark ping and error stream events as supported:

https://github.com/ollama/ollama/blob/f63eea3d273816ffc27fbeb0662ab44d236abc45/docs/api/anthropic-compatibility.mdx#L334-L343

But StreamConverter.Process never emits those event types. The same page also lists server-sent streaming errors as unsupported:

https://github.com/ollama/ollama/blob/f63eea3d273816ffc27fbeb0662ab44d236abc45/docs/api/anthropic-compatibility.mdx#L414

Introduced by:

4. macOS uninstall docs quote ~, so shell expansion does not happen

The uninstall docs use quoted tilde paths:

https://github.com/ollama/ollama/blob/f63eea3d273816ffc27fbeb0662ab44d236abc45/docs/macos.mdx#L38-L39

In bash/zsh, ~ is not expanded inside quotes, so these commands target a literal ~ path instead of the userโ€™s home directory.

Introduced by:

5. Pi integration still references the old npm package scope

The Pi integration docs and launcher still install:

  @mariozechner/pi-coding-agent

https://github.com/ollama/ollama/blob/f63eea3d273816ffc27fbeb0662ab44d236abc45/docs/integrations/pi.mdx#L11-L12
The package has moved to:

  @earendil-works/pi-coding-agent

Candidate fixes

I have five small commits prepared:

Happy to open PR(s) for these if useful.

Relevant log output

OS

No response

GPU

No response

CPU

No response

Ollama version

No response

Vote matrix ยท Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loadingโ€ฆ

Still need to ship something?

ร—6

Another batch ranked right after the header list โ€” different links, same matching logic.

Back to top recommendations

TRENDING