Fully autonomous AI Agents system capable of performing complex penetration testing tasks
Go ai-agentsai-security-toolanthropicautonomous-agentsgolanggptgraphqlmulti-agent-systemoffensive-securityopen-sourceopenaipenetration-testingpenetration-testing-toolsreactsecurity-automationsecurity-testingsecurity-toolsself-hosted
docs: clarify "primary docker image" error is an LLM backend failure (#309)
mason50523012ddd34273
diff --git a/README.md b/README.mdindex 3af17d0f..2d72a60a 100644--- a/README.md+++ b/README.md@@ -2689,6 +2689,21 @@ On Linux, this is typically configured in `/etc/docker/daemon.json`. On Docker DSee the official Docker documentation for [registry mirrors](https://docs.docker.com/docker-hub/image-library/mirror/) and [daemon proxy configuration](https://docs.docker.com/engine/daemon/proxy/).+#### Troubleshooting: "failed to select primary docker image via llm call"++A flow that fails immediately with `failed to select primary docker image via llm call` usually indicates a problem with the configured LLM backend, not with Docker or the image registry. Older PentAGI versions reported the same failure as `failed to get primary docker image`, which led users to debug Docker even though the registry was healthy.++When a flow starts, PentAGI makes its first LLM call to choose the primary Docker image for the task. If that call fails, the error is surfaced at this image-selection step. A message such as `API returned unexpected status code: 502` or `404` in this context is returned by the LLM backend, not by Docker Hub.++This is distinct from the registry reachability problems described above: if Docker pulls succeed and the Compose stack starts, but flow creation still fails at image selection, investigate the LLM backend rather than Docker.++To diagnose:++1. Check PentAGI logs first: `docker logs pentagi`.+2. Check the logs of your configured LLM backend (the server behind your provider or `LLM_SERVER_URL`).+3. Verify that the base URL, API key, and model name in [Custom LLM Provider Configuration](#custom-llm-provider-configuration) are correct and reachable from the container.+4. For custom, OpenAI-compatible, vLLM, or sglang backends, confirm that the model supports tool calling / function calling and that the matching tool-call parser is enabled. A missing or mismatched tool-call parser is a known cause of this failure.+## Development### Development Requirements