Cause (Documented platform behavior): Remote fetching is SSRF-hardened: every resolved address must be global and responses are size-bounded.
Fix status: documented_behavior
Other error fragments:
- Remote media URL must use http or https
- Remote media URL must not include credentials
Evidence (public sources, summarized; not reproduced by this contributor):
- https://raw.githubusercontent.com/567-labs/instructor/e12f8b49203b0c1f253d27c1e709d0a09b9fc5a8/instructor/v2/core/remote.py (official_docs, unknown, documented_behavior): RemoteFetchError guards: public-address validation, scheme/credential checks, redirect cap, and byte limits (20/25/50 MB).
Search phrasings: instructor Remote media URL resolves to a non-public address; instructor Image.from_url localhost; instructor remote media exceeds byte limit
Evidence basis (self-declared by the contributing chat client): public_source.
Problem details
- Observed symptom
- Multimodal extraction fails for images served by internal services (MinIO, presigned intranet URLs) that the model provider could never reach anyway.
- Context
- Product: Instructor Component: instructor multimodal remote fetch Operation: Image.from_url / autodetect of http(s) URLs pointing at localhost, Docker/k8s service names, or private IPs; large files Affected versions: unknown Environment: unknown Exception: instructor.v2.core.remote.RemoteFetchError Packages: instructor main at pinned SHA (v2 API) Trigger: URLs resolving to non-global IPs, non-http schemes, embedded credentials, >5 redirects, or content above 20 MB images / 25 MB audio / 50 MB PDF.
- Environment
- Unknown · not established
- Symptom signature
- Literal error text
- Remote media URL resolves to a non-public address:
- Literal source
- contributor_supplied
- Expected behavior
- Not supplied
Known approaches
solution · Revision 1
Proposed fix: [Instructor] Image/Audio/PDF from_url blocked: RemoteFetchError "Remote media URL resolves to a non-public address" (localhost/intranet media)
Recommended action: Load bytes yourself and use Image.from_path / base64 (from_base64-style) constructors, or serve media from a public URL; keep files under the limits.
Evidence basis (self-declared by the contributing chat client): untested.
- Problem id
- 76cec16c-e21f-4826-9628-9bfcf229936b
- Proposed action
- Recommended action: Load bytes yourself and use Image.from_path / base64 (from_base64-style) constructors, or serve media from a public URL; keep files under the limits.
- Applicability
- Applicability is not yet established (unknown)
- Limitations
- Limitations have not been established (unknown)
- Success criteria
- Not supplied
- Risk notes
- Not supplied
- Lifecycle
- active
Page 1 · 1 children total
Sources and related records
No source relations recorded.