ErrLookup › xtekky/gpt4free
xtekky/gpt4free
The official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3 · Python · 293 source files
Analyzed at 973504e177 on 2026-08-14. 374 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| {r.status} {response body text} | http | critical | runtime, python, bootstrap, filesystem |
| No audio chunks | exception | critical | build, embed, runtime, bootstrap |
| No user message found in messages | validation | error | embed, build-cache, go |
| Failed to extract nonce/sig from __data.json. Got: {tap_data | exception | error | embed, io, memory, zip |
| Failed to get conversation ID from /new: {new_data} | exception | error | zip, extraction, filesystem, windows |
| CDP module is required for Cloudflare provider. Please ensur | exception | error | pip, network, python-3-14, install |
| WebSocket error inside Cloudflare session | exception | error | pip, ensurepip, python, environment |
| Timeout waiting for Cloudflare response | exception | error | android, termux, exec, package-manager |
| Install or update "curl_cffi" package | pip install -U curl_ | exception | warning | android, termux, build, runtime |
| Status 401: Invalid session | http | error | android, termux, build, prerequisites |
| Missing cookie: {cls.anon_cookie_name} | exception | error | android, filesystem, build, staging |
| Error: {msg} | exception | error | android, clang, build, linker, termux |
| Invalid response: {last_msg} | exception | critical | android, dlopen, linker, rpath, c |
| No session found in .har files | exception | critical | android, dlsym, abi, cpython, c |
| Failed to start conversation: {await resp.text()} | http | error | http, copilot, session, upstream |
| WebSocket Error: {ws.exception()} | exception | error | websocket, network, copilot, transport |
| Error during CopilotApp interaction: {e} | exception | error | wrapper, copilot, error-chaining |
| Error: {msg} | exception | error | websocket, upstream, copilot, content-policy |
| Invalid response: {last_msg} | exception | error | websocket, streaming, auth, copilot |
| Failed to upload file: {response.status} {error_text} | http | error | upload, http, file-attachment, api, deepai |
| Failed to upload file: {res_json} | exception | error | deepai, file-upload, media, image, upstream-api |
| Failed to chat: {response.status} {error_text} | http | error | deepai, http-error, rate-limit, chat, upstream-api |
| Failed to obtain Turnstile token for DeepInfra request. | exception | error | deepinfra, turnstile, cloudflare, auth, captcha, api-key |
| Upload failed: {result} | exception | error | opera, file-upload, media, polling, upstream-api |
| Upload timeout for {file_id} | exception | error | opera, timeout, file-upload, polling |
| No response | exception | warning | perplexity, quota, empty-response, scraping, auth |
| Failed to extract nonce from PhindAi response | exception | error | phind, nonce, scraping, wordpress, anti-csrf |
| Failed to decode JSON from PhindAi response: {text} | exception | error | phind, json-decode, scraping, rate-limit, upstream-api |
| PhindAi API returned success=False: {data} | exception | error | phind, nonce, rate-limit, scraping, api-response |
| {item} | exception | error | pollinations, image-generation, auth, batch, missing-auth |
| {data['code']}:{data['details']} | exception | error | qwen, file-upload, rate-limit, quota, media |
| {captcha} | exception | error | qwen, captcha, anti-bot, nodriver, browser, baxia |
| {message or html} | exception | error | qwen, waf, cloudflare, anti-bot, aliyun, proxy |
| Failed to extract bx-umidtoken. | exception | error | qwen, umidtoken, device-fingerprint, anti-bot, scraping |
| Failed to create chat: {data} | exception | error | qwen, conversation, api-response, auth, upstream-api |
| Response: {resp_json} | exception | error | qwen, rate-limit, json-response, moderation, model-access |
| {error["code"]}: {error["details"]} | exception | error | qwen, sse, mid-stream-error, moderation, rate-limit |
| The Qwen provider reached the request limit after 5 attempts | exception | error | qwen, rate-limit, retry-exhausted, quota, backoff |
| The Qwen provider reached the limit Cloudflare. | exception | critical | qwen, waf, browser, bootstrap, nodriver, rate-limit |
| No Yupp accounts configured. Set YUPP_API_KEY environment va | exception | error | yupp, authentication, api-key, configuration |
| cloudscraper library is required for Yupp provider | install | exception | error | yupp, dependencies, cloudscraper, installation |
| No valid Yupp accounts available | exception | error | yupp, rate-limit, account-rotation, credits |
| Yupp request failed: {str(e)} | exception | error | yupp, network, exception-chaining, cloudflare |
| All Yupp accounts failed after rotation attempts | exception | error | yupp, account-rotation, upstream-outage, retry-exhausted |
| module 'g4f.Provider' has no attribute '{name}' | exception | error | provider-registry, lazy-import, version-compat, attributeerror |
| Provider '{item}' not found | exception | error | provider-registry, dict-access, validation |
| Label must be provided | validation | warning | provider-registry, validation, empty-input |
| Provider with label '{label}' not found | validation | error | provider-registry, label-resolution, validation |
| Prompt is empty. | validation | error | edgetts, tts, validation, empty-input |
| No voices found for language '{audio.get('language')}' and l | validation | error | edgetts, tts, locale, voice-selection |
| Prompt is empty. | validation | error | elevenlabs, tts, validation, empty-input |
| hCaptcha accessibility cookie required: log in at https://da | exception | error | elevenlabs, hcaptcha, browser-automation, authentication |
| No audio chunks received from ElevenLabs. | exception | error | elevenlabs, browser-automation, fragile-scraping, tts |
| MarkItDown requires media to be provided. | validation | error | markitdown, media-required, validation |
| MarkItDown is not installed. Please install it with `pip ins | exception | error | markitdown, dependencies, installation |
| No valid audio data found for transcription | validation | error | pollinations-audio, transcription, file-handling, validation |
| Prompt is empty. | validation | error | gtts, tts, validation, empty-input |
| GitHub Copilot OAuth not configured. Please run 'g4f auth gi | exception | error | authentication, oauth, github-copilot, missing-credentials |
| device_code is required for polling | validation | error | oauth, device-flow, validation, github-copilot |
| Failed to fetch Copilot usage: {resp.status} {text} | exception | error | quota, http-error, github-api, github-copilot |
NO_TOKEN No GitHub OAuth token available. Please login first. | exception | error | authentication, token-manager, oauth, github-copilot |
AUTH_FAILED GitHub token is invalid or expired. Please login again. | exception | error | authentication, http-401, token-exchange, github-copilot |
TOKEN_ERROR Failed to get Copilot token: {resp.status} - {text} | exception | error | token-exchange, http-error, rate-limit, github-copilot |
| Device authorization failed {resp.status}: {resp_json} | exception | error | oauth, device-flow, http-error, github |
| Device authorization error: {resp_json.get('error')} - {resp | exception | error | oauth, device-flow, validation, github |
| Device code expired. Please try again. | exception | error | oauth, device-flow, expiry, github |
| Authorization was denied by the user. | exception | error | oauth, device-flow, access-denied, github |
TokenError.FILE_ACCESS_ERROR Credentials file not found | exception | error | credentials, file-io, token-manager, configuration |
| Cannot validate GLM account (status {response.status}) | exception | error | authentication, http-error, glm, api-key |
| No user ID in auth response | exception | error | glm, schema-drift, validation, api-response |
| Cannot create GLM chat session (status {response.status}) | exception | error | glm, http-error, chat-session, rate-limit |
| Failed to obtain API key from Z.ai authentication endpoint | exception | error | glm, api-key, bootstrap, configuration |
| Aliyun captcha SDK failed to load | exception | error | captcha, browser, timeout, glm, headless |
| Captcha solver returned an invalid token: {param!r} | exception | error | captcha, glm, browser, anti-bot |
| GLM captcha solving failed after {SOLVE_RETRIES} attempts: { | exception | error | captcha, glm, retry, timeout |
| Failed to parse message: {chunk.decode(errors='replace')} | exception | error | hf-space, gradio, sse, json, image-generation |
| No media files provided for image generation. | exception | error | hf-space, image-generation, validation, input-required |
| Model {model} not found | exception | error | model-not-found, hf-space, cohere, validation |
| Failed to read response: {chunk.decode(errors='replace')} | exception | error | hf-space, json, streaming, ndjson, parser-bug |
| GPU token limit exceeded: {chunk.decode(errors='replace')} | exception | error | hf-space, zerogpu, quota, image-generation, gradio |
| Failed to parse image URL: {chunk.decode(errors='replace')} | exception | error | hf-space, json, gradio, sse, image-generation |
| Response {response.status}: {message} | exception | error | http, hf-space, status-code, auth |
| Install "gpt4all" package | pip install -U g4f[local] | exception | error | local, dependencies, gpt4all, install |
| Ollama session cookie is invalid or expired. | exception | error | auth, ollama, cookies, session-expired |
| Failed to get quota information from Ollama: {e} | exception | error | ollama, quota, scraping, wrapper |
| Failed to find quota information in Ollama settings page. | exception | warning | ollama, quota, scraping, layout-change |
| Ratelimit Exceeded! | exception | error | rate-limit, airforce, streaming, throttle |
| Add a "api_key" | exception | error | auth, anthropic, api-key, missing-credentials |
| OAuth error: {OAuthCallbackHandler.callback_error} | exception | error | oauth, antigravity, auth, callback |
| Failed to read OAuth credentials from {path}: {e} | exception | error | oauth, antigravity, json, credentials, cache |
| ANTIGRAVITY_SERVICE_ACCOUNT environment variable not set. Pl | exception | error | auth, antigravity, environment, credentials, setup |
| No refresh token found in credentials. | exception | error | oauth, antigravity, token-refresh, credentials |
| Token refresh failed: {text} | exception | critical | oauth, authentication, google, antigravity, network |
| No access_token in refresh response. | exception | critical | oauth, authentication, proxy, antigravity |
| All Antigravity endpoints failed. Last error: {last_error} | exception | error | network, antigravity, retry, upstream |
| Missing PKCE verifier in state parameter | exception | error | oauth, pkce, antigravity, state |
| Token exchange failed: {error_text} | exception | error | oauth, google, authorization-code, antigravity |
| Missing tokens in response | exception | error | oauth, refresh-token, google, antigravity |
| Account not eligible for Antigravity Code Assist. | exception | error | authorization, antigravity, google-workspace, onboarding |
| OAuth callback timed out | exception | error | oauth, callback, localhost, antigravity, login |
| No authorization code received | exception | error | oauth, consent, callback, antigravity |
| No input provided | exception | warning | login, manual-flow, input-validation, antigravity |
| Could not extract authorization code | exception | warning | login, manual-flow, oauth, antigravity |
| No valid access token available for project discovery | exception | error | authentication, project-id, antigravity, initialization |
| Project ID discovery failed - set ANTIGRAVITY_PROJECT_ID in | exception | error | project-id, gcp, antigravity, configuration |
| Could not discover project ID. Ensure authentication or set | exception | error | network, project-id, antigravity, wrapper |
| Cannot fetch usage without valid authentication | exception | error | authentication, quota, antigravity, project-id |
| Invalid AZURE_API_KEYS environment variable | exception | error | configuration, environment, json, azure |
| Invalid AZURE_ROUTES environment variable format: {routes} | exception | error | configuration, environment, json, azure |
| No API endpoint found for model: {model} | exception | error | configuration, model-routing, azure, model-not-found |
| API key is required for Azure provider. Ask for API key in t | exception | error | configuration, api-key, azure, environment |
| API key has failed too many times. | exception | error | api-key, circuit-breaker, azure, authentication |
| {e}. Ask for help in the {cls.login_url} Discord server. | exception | error | authentication, azure, provider, credentials |
| Missing "_U" cookie | exception | error | authentication, cookies, bing, image-generation |
| No valid Blackbox session found. Please log in to Blackbox A | exception | error | authentication, har-file, cookies, blackbox, session |
| {chunk_text} | exception | error | rate-limit, quota, streaming, blackbox |
| Claude cookie not found. Please set the 'CLAUDE_COOKIE' envi | exception | error | authentication, cookies, environment-variable, claude |
| Claude organization ID not found. Please set the 'CLAUDE_ORG | exception | error | authentication, configuration, environment-variable, claude |
| Add a "api_key" | exception | error | authentication, api-key, cohere |
| Cohere API Error: {data['error']} | exception | error | api-error, cohere, response-parsing |
| wasmtime and numpy are required for PoW solving | exception | error | dependencies, import-error, deepseek, wasm |
| WASM file not found: {wasm_path} | exception | error | file-not-found, deepseek, wasm, packaging |
| Failed to upload file: {result} | exception | error | file-upload, deepseek, media, response-parsing |
| DeepSeekAuth: No authentication found. | exception | error | authentication, har-file, deepseek, quota |
| DeepSeekAuth: No authentication found. Please add a DeepSeek | exception | error | authentication, har-file, deepseek, cookies |
| DeepSeekAuth: Authorization token required. Please ensure HA | exception | error | authentication, bearer-token, deepseek, har-file |
| Failed to parse session response: {session_data} | exception | error | response-parsing, deepseek, session, api-change |
| Expected SSE response but got content-type: {content_type} | exception | error | streaming, sse, content-type, deepseek |
| Gemini stream was idle for {idle_timeout:g} seconds | exception | error | timeout, streaming, gemini, network |
| Invalid thinking mode: {think_value!r} | validation | error | validation, gemini, model-name, configuration |
| Thinking mode must be an integer between 0 and 4 | validation | error | validation, gemini, range-check, configuration |
| Unknown Gemini model: {model}. Supported models: {', '.join( | validation | error | validation, gemini, model-name, unknown-model |
| No refresh token found in GCP_SERVICE_ACCOUNT. | validation | error | auth, oauth, gemini, credentials, configuration |
| Token refresh failed: {text} | exception | error | auth, oauth, gemini, http, token-refresh |
| No access_token in refresh response. | exception | error | auth, oauth, gemini, network, response-parsing |
| API call failed with status {resp.status}: {text} | http | error | gemini, http, api, quota, error-handling |
| No project information found in API response. | exception | error | gemini, gcp, project, onboarding, configuration |
| Could not discover project ID. Ensure authentication or set | exception | error | gemini, gcp, error-handling, network, project |
| Account not eligible for Gemini Code Assist. | validation | critical | gemini, auth, authorization, onboarding, eligibility |
| Failed to retrieve user quota: {response.status} {error_body | http | warning | gemini, quota, http, gcp |
| Missing PKCE verifier in state parameter | validation | error | oauth, pkce, gemini, login, state |
| Token exchange failed: {error_text} | exception | error | oauth, gemini, login, token-exchange, http |
| Missing tokens in response | exception | error | oauth, gemini, login, response-parsing, network |
| OAuth callback timed out | exception | error | oauth, gemini, login, callback-server, localhost |
| No authorization code received | exception | error | oauth, gemini, login, consent, authorization-code |
| No input provided | validation | warning | oauth, gemini, login, cli, user-input |
| Could not extract authorization code | validation | warning | oauth, gemini, login, cli, url-parsing |
| Missing "api_key" | validation | error | auth, gigachat, api-key, configuration, missing-credentials |
| Invalid secrets | validation | critical | auth, grok, cookies, http-403, cloudflare |
| Failed to get upload URL | exception | error | lmarena, nextjs, upload, image, scraping, cloudflare |
| Failed to get download URL | exception | error | lmarena, image-upload, auth, server-action |
| No authentication arguments found. | exception | error | lmarena, auth, cache, quota |
| No auth file found and nodriver is not available. | exception | error | lmarena, optional-dependency, nodriver, auth |
| Model '{_model}' is not supported by LMArena provider. | exception | error | lmarena, model-not-found, validation |
| LMArena Beta encountered an error: hasArenaError | exception | error | lmarena, streaming, server-error, transient |
| LMArena: {json.loads(line[3:])} | exception | error | lmarena, streaming, backend-error, runtime |
| Response: Something Went Wrong | exception | error | metaai, response-format, session-expiry, bot-detection |
| \n".join([error.get("message") for error in json_line.get("e | exception | error | metaai, graphql, session-expiry, runtime |
| Meta AI isn't available yet in your country | exception | error | metaai, geo-restriction, proxy, auth |
| Response: {text} | exception | warning | metaai, parsing, sources, schema-change |
| No access token found in .har files | exception | error | microsoft-designer, har, auth, credentials |
| Invalid image element: {element} | exception | error | openai-chat, image-generation, parsing, schema-change |
| Access token is not valid | exception | error | openai-chat, auth, access-token, media-upload |
| Response status: {response.status} | exception | error | openai-chat, auth, cloudflare, http-403 |
| (await response.json()), data | exception | error | openai-chat, validation, http-422, payload |
| line.get("error") | exception | error | openai-chat, streaming, in-band-error, runtime |
| Missing access token | exception | error | openai-chat, auth, har, access-token |
| Access token is not valid: {cls.request_config.access_token} | exception | error | authentication, har-file, token-expired, g4f |
| API key is required for Puter.js API | exception | error | authentication, missing-api-key, puter, g4f |
| result["error"].get("message", result["error"]) | exception | error | streaming, sse, upstream-error, puter, g4f |
| result | exception | error | json, upstream-error, response-parsing, puter, g4f |
| Unexpected content type: {mime_type} | exception | error | http, content-type, proxy, puter, g4f |
| No cookies found for {cls.domain} | validation | error | authentication, cookies, reka, g4f |
| No appSession found in cookies for {cls.domain}, log in or p | validation | error | authentication, cookies, session-expired, reka, g4f |
| Failed to get access token: {e}, refresh your cookies / log | validation | error | authentication, token-refresh, reka, g4f |
| api_key is missing | exception | error | authentication, missing-api-key, replicate, g4f |
| Invalid response: {result} | exception | error | api, response-parsing, replicate, g4f |
| Model '{model}' is not supported by {cls.__name__}. Supporte | validation | warning | validation, model-name, video, g4f |
| Prompt cannot be empty. | validation | warning | validation, empty-prompt, video, g4f |
| Failed to find any videos for the prompt. | exception | warning | no-results, video-search, runtime, g4f |
| line[6:] | exception | error | streaming, sse, upstream-error, you, g4f |
| Install "beautifulsoup4" package | exception | error | dependencies, missing-package, beautifulsoup4, bing, g4f |
| No coins left. Log in with a different account or wait a whi | exception | error | rate-limit, quota, bing, image-generation, g4f |
| Create images failed: {error} | exception | error | content-policy, bing, image-generation, g4f |
| Create images failed. Code: {response.status} | exception | error | http, redirect, cookies, bing, image-generation, g4f |
| Timeout error after {timeout} sec | exception | warning | timeout, polling, bing, image-generation, g4f |
| Polling images faild. Code: {response.status} | exception | error | polling, http, retry, bing, image-generation, g4f |
| Prompt is been blocked | exception | error | bing, image-generation, content-moderation, runtime-error |
| {error} | exception | error | bing, image-generation, upstream-error, runtime-error |
| Bad images found | exception | error | bing, image-generation, content-moderation, validation |
| No images found | exception | error | bing, image-generation, parsing, scraper-drift |
| {message}: {model} | exception | error | gemini, rate-limit, api-error, provider |
| Install "curl_cffi" package | pip install -U curl_cffi | exception | error | huggingchat, dependencies, environment, missing-requirements |
| Response: {line} | exception | error | huggingchat, streaming, protocol-change, runtime-error |
| Failed to decode JSON: {e} | exception | error | huggingchat, authentication, json-decoding, cloudflare |
| Add a "api_key" | exception | error | huggingface, authentication, api-key, media-generation |
| Model is not supported: {model} in: {cls.__name__} | exception | error | huggingface, model-not-found, media-generation, validation |
| Model is not supported: {model} in: {cls.__name__} task: {ta | exception | error | huggingface, model-not-supported, task-mismatch, media-generation |
| Unexpected response: {result} | exception | error | huggingface, image-generation, unexpected-response, parsing |
| har_and_cookies dir is not readable | exception | error | openai, har-file, permissions, filesystem, auth |
| No .har file found | exception | error | openai, har-file, missing-file, auth, setup |
| The .har file is not valid | exception | error | openai, har-file, arkose, auth, bot-detection |
| No proof_token found in .har files | exception | error | openai, har-file, proof-token, auth, bot-detection |
| Failed to solve 'gAAAAAB' challenge | exception | error | openai, proof-of-work, anti-bot, rate-limit |
| Failed to solve 'gAAAAAC' challenge | exception | error | openai, proof-of-work, anti-bot, version-skew |
| Error processing token {token}: {exc} | exception | error | cloudflare, turnstile, anti-bot, openai |
| No valid access token obtained. | exception | error | qwen, oauth, authentication, credentials |
| Device authorization failed {resp.status}: {resp_json} | exception | error | qwen, oauth, device-flow, network |
| Device authorization error: {resp_json.get('error')} - {resp | exception | error | qwen, oauth, device-flow, api-contract |
| Token poll failed {resp.status}: {resp_json} | exception | error | qwen, oauth, device-flow, polling |
| No refresh token | exception | error | qwen, oauth, refresh-token, validation |
| Refresh token expired or invalid | exception | critical | qwen, oauth, refresh-token, reauthentication |
REFRESH_FAILED {e} | exception | error | qwen, token-manager, refresh, error-wrapping |
FILE_ACCESS_ERROR {e} | exception | error | qwen, credentials, file-io, permissions |
NO_REFRESH_TOKEN No refresh token | exception | error | qwen, token-manager, refresh-token, authentication |
LOCK_TIMEOUT Failed to acquire lock | exception | error | qwen, token-manager, file-lock, concurrency |
| Install "ddgs" and "beautifulsoup4" | pip install -U g4f[sea | exception | warning | search, dependencies, ddgs, setup |
| Google requires a browser to be installed. | exception | warning | search, google, nodriver, dependencies |
| Model {model} not found. | exception | error | |
| model must be 'mp3' or 'high-definition' | validation | error | |
| API key is required. | exception | error | |
| No default model specified. | exception | error | |
| No base_url or backup_url specified. | exception | error | |
| Invalid API key for the specified base_url. | validation | error | |
| Add a "api_key" | exception | error | |
| Unexpected response: {response.text} | exception | error | |
| Unexpected content type: {content_type} | exception | error | |
| a2wsgi is required for GUI. Install it with: pip install a2w | exception | error | |
| Incorrect username or password | http | error | |
| Tool loop detected: request contains {total_tool_calls} tool | exception | error | |
| Tool loop detected: function '{key[0]}' was called {call_cou | exception | error | |
| Tool loop detected: function '{key[0]}' returned empty resul | exception | error | |
| No response received | console | error | |
| Install markitdown | exception | error | |
| No media response from {provider_name} | exception | error | |
| Provider {provider_name} does not support image generation | validation | error | |
| Providers not found: {provider} | exception | error | |
| Provider not found: {provider} | exception | error | |
| Model not found: {model} | exception | error | |
| Unexpected type: {type(model)} | validation | error | |
| No provider found for model: {model} | exception | error | |
| {provider_name} is not working | exception | error | |
| {provider_name} does not support "stream" argument | exception | error | |
| Install "browser_cookie3" package | exception | error | |
| Install "gui" requirements | pip install -U g4f[gui] {import | exception | error | |
| Unsupported file type: {filename} | validation | error | |
| Install "pillow" package for images | exception | error | |
| Install "cairosvg" package for svg images | exception | error | |
| Invalid data URI image. {data_uri[:10]}... | validation | error | |
| Invalid image format (from mime file type). | validation | error | |
| Invalid image format (from magic code). | validation | error | |
| Unknown or unsupported file type | validation | error | |
| Invalid or disallowed media URL | validation | error | |
| File not found: {path} | exception | error | |
| Invalid or unsafe image url | validation | error | |
| Invalid image url. Expected bytes, str, or PIL Image. | validation | error | |
| Invalid image format or file not found. Expected bytes, str, | validation | error | image, input-validation, bytes |
| Invalid input audio | validation | error | audio, input-validation, extension |
| Response must be a dict or have headers | validation | error | media, input-validation, content-type |
| Unsupported media type: {content_type} | validation | error | media, content-type, validation |
| Invalid or unsafe image url: {image} | validation | error | security, ssrf, url-validation, network |
| Unsupported media type: {media_type} | validation | error | media, content-type, download, validation |
| Could not convert stream to Markdown. No converter attempted | exception | error | markitdown, file-conversion, unsupported-format |
| url must not be None | validation | error | markitdown, url, precondition |
| url must be a non-empty string | validation | error | markitdown, url, input-validation |
| url must start with http:// or https:// | validation | error | markitdown, url, scheme, input-validation |
| Speech transcription requires installing MarkItdown with the | exception | error | markitdown, audio, missing-dependency, environment |
| Unsupported audio format: {audio_format} | validation | error | markitdown, audio, format, validation |
| Operation failed after {retries} attempts. | exception | error | markitdown, youtube, retry, network |
| Model "{model}" not found / not yet implemented | validation | error | local-provider, model, validation, gpt4all |
| Model "{model_file}" not found. | validation | error | local-provider, model-download, gpt4all, interactive |
| Syntax error in workspace module '{name}' ({source_path}):\n | exception | error | sandbox, syntax-error, workspace, pa-provider |
| Failed to load workspace module '{name}' ({source_path}):\n{ | exception | error | sandbox, import-error, workspace, pa-provider |
| Relative imports are not allowed inside a .pa.py sandbox. | exception | error | sandbox, relative-import, workspace, pa-provider |
| '{name}' is not available in the restricted os shim. | exception | error | sandbox, import, security, os-module, pa-provider |
| Cannot find submodule '{name}' in workspace module '{base}'. | exception | error | sandbox, import, workspace, pa-provider |
| Import of '{name}' is not allowed in safe execution mode.\nA | exception | error | sandbox, import, allowlist, security, pa-provider |
| Import of '{name}' is not allowed inside a .pa.py sandbox fo | exception | error | sandbox, security, import, credentials, g4f |
| File access outside workspace is denied: '{file}'. Workspace | exception | error | sandbox, filesystem, security, permissions, pa-provider |
| Invalid file path: '{file}' | validation | error | sandbox, filesystem, path-validation, pa-provider |
| PA provider file not found: {file_path} | exception | error | filesystem, pa-provider, path, validation |
| File must have .pa.py extension: {file_path} | validation | error | pa-provider, validation, file-extension |
| Failed to load PA provider from {file_path}:\n{result.error} | exception | error | pa-provider, sandbox, runtime, timeout, loading |
| Install "nest-asyncio2" package | pip install -U nest-asynci | exception | error | asyncio, event-loop, dependency, jupyter |
| The operation timed out after {} seconds | exception | error | asyncio, timeout, network |
| The operation timed out after {} seconds | exception | error | asyncio, timeout, streaming, network |
| {provider.__name__} does not implement an async method | exception | error | provider, api-contract, not-implemented |
| {provider.__name__} does not implement a create method | exception | error | provider, api-contract, not-implemented |
| {cls.__name__} does not implement get_quota method | exception | warning | provider, quota, not-implemented |
| API key is required. | exception | error | auth, api-key, quota, provider |
| API key is required for {cls.__name__} | exception | error | authentication, api-key, missing-credentials, g4f |
| Failed to save: {auth_result.get_dict()}\n{type(e).__name__} | exception | error | serialization, auth-cache, json, g4f |
| Invalid auth file: {cache_file} | exception | error | auth-cache, corrupt-file, json, authentication, g4f |
| The operation timed out after {} seconds in {} | exception | error | timeout, streaming, asyncio, network, g4f |
| Unexpected end of condition expression | validation | error | config, yaml, condition-parser, validation, g4f |
| Unknown variable in condition: {root!r} | validation | error | config, yaml, condition-parser, unknown-variable, g4f |
| Cannot access field {part!r} on non-dict value while resolvi | validation | error | config, yaml, condition-parser, schema-mismatch, g4f |
| Unexpected token {kind!r}={value!r} in condition expression | validation | error | config, yaml, condition-parser, syntax-error, g4f |
| Provider not found: {provider_name!r} | validation | error | config, yaml, provider-resolution, typo, g4f |
| {provider_name} has no supported create method | exception | error | config, yaml, provider-resolution, not-implemented, g4f |
| config.yaml: No provider succeeded for model {model!r}. Trie | exception | critical | config, yaml, provider-chain, all-providers-failed, g4f |
| RotatedProvider requires a non-empty list of providers. | validation | error | constructor, validation, provider-rotation, empty-list, g4f |
| No providers available | exception | error | retry, provider-chain, empty-list, configuration, g4f |
| RetryProvider failed:\n{p}: {type(exception).__name__}: {exc | exception | critical | retry, aggregated-error, provider-chain, all-providers-failed, g4f |
| No content response from any provider. | exception | error | retry, empty-response, provider-chain, g4f |
| Install "curl_cffi" package | pip install -U curl_cffi | exception | error | dependencies, missing-package, curl-cffi, installation, g4f |
| Install "webview" package | exception | warning | dependencies, missing-package, webview, headless, g4f |
| Bad url: {url} | validation | error | url-validation, cookies, valueerror, input-validation |
| Missing CDP requirements | exception | error | missing-dependency, cdp, import-error, aiohttp, websocket |
| Install "zendriver" and "platformdirs" package | pip install | exception | error | missing-dependency, zendriver, nodriver, browser-automation |
| Nodriver is already in use, please try again later. | exception | error | concurrency, lock-file, nodriver, timeout, browser-automation |
| Invalid JSON data: {rest} | validation | error | sse, streaming, json, malformed-response, parsing |
| Install "aiohttp_socks" package for proxy support | exception | error | proxy, socks, missing-dependency, aiohttp, aiohttp-socks |
| Google Chrome / Chromium / Edge executable not found. | exception | critical | cdp, browser-not-found, environment, chrome, deployment |
| Failed to start shared Chrome on port {port} | exception | error | cdp, chrome-startup, retryable, docker, sandbox |
| Failed to create new tab target on port {self.port} | exception | error | cdp, tab-target, websocket, connection, chrome |
| CDPSession is not connected | exception | error | cdp, lifecycle, not-connected, asyncio, state-error |
| CDP call {method} timed out after 30 seconds | exception | error | cdp, timeout, websocket, retryable, performance |
| Timeout waiting for event {method} | exception | warning | cdp, timeout, events, race-condition, lifecycle |
| Install "websocket-client" package: pip install websocket-cl | exception | error | missing-dependency, websocket-client, cdp, sync, import-error |
| CDP error in {method}: {response['error']} | exception | error | cdp, protocol-error, chrome, api-misuse |
| curl_cffi is not available on this platform | exception | error | curl-cffi, missing-dependency, platform-support, binary-incompatible, import-error |
| curl_cffi FormData is not available on this platform | exception | error | curl-cffi, multipart, form-data, version-mismatch, missing-dependency |
| curl_cffi WebSocket is not available on this platform | exception | error | curl-cffi, websocket, version-mismatch, missing-dependency, platform-support |
| Response {response.status}: {message} | exception | error | rate-limit, http-429, async, g4f |
| Response {response.status}: Cloudflare detected | exception | error | cloudflare, http-403, bot-protection, async |
| Response {response.status}: OpenAI Bot detected | exception | error | http-403, bot-detection, recaptcha, openai, async |
| Response {response.status}: Bad Gateway | exception | error | http-502, bad-gateway, transient, async |
| Response {response.status}: Gateway Timeout | exception | error | http-504, gateway-timeout, rate-limit, async |
| Response {response.status}: Invalid API key | exception | error | api-key, http-400, auth, gemini, async |
| Response {response.status}: {'HTML content' if is_html else | exception | error | http-status, fallback, provider-error, async |
| Response {response.status_code}: {message} | exception | error | rate-limit, http-429, sync, g4f |
| Response {response.status_code}: Cloudflare detected | exception | error | cloudflare, http-403, bot-protection, sync |
| Response {response.status_code}: OpenAI Bot detected | exception | error | http-403, bot-detection, openai, sync |
| Response {response.status_code}: Bad Gateway | exception | error | http-502, bad-gateway, transient, sync |
| Response {response.status_code}: Gateway Timeout | exception | error | http-504, gateway-timeout, rate-limit, sync |
| Response {response.status_code}: Invalid API key | exception | error | api-key, http-400, auth, sync |
| Response {response.status_code}: {'HTML content' if is_html | exception | error | http-status, fallback, provider-error, sync |
| Install "pypdf2" requirements | pip install -U g4f[files] | exception | warning | missing-dependency, pdf, extras, g4f |
| Install "docx" requirements | pip install -U g4f[files] | exception | warning | missing-dependency, docx, extras, g4f |
| Install "beautifulsoup4" requirements | pip install -U g4f[f | exception | warning | missing-dependency, html, beautifulsoup4, extras |
| Install "spacy" requirements | pip install -U g4f[files] | exception | warning | missing-dependency, spacy, nlp, chunking |
| Tool function arguments must be a dictionary or a json strin | validation | error | tool-calling, json, validation, llm-output |
| pystray is required for system tray support. Install it with | exception | error | import-error, optional-dependency, tray, installation |
| pillow is required for system tray support. Install it with: | exception | error | import-error, optional-dependency, pillow, tray, fallback |
| Failed to get PyPI version for '{package_name}' | exception | warning | network, pypi, version-check, update-check |
| No tag_name found in latest GitHub release for '{repo}' | exception | warning | network, github-api, version-check, release |
| Failed to get GitHub release version for '{repo}' | exception | warning | network, github-api, rate-limit, version-check |
| no runtime in manifest for platform %q | error_code | critical | go, runtime-manifest, platform-support, unsupported-platform |
| download failed: %w | error_code | error | go, network, download, tls, proxy |
| download failed: HTTP %s | http | error | go, download, http-status, runtime-manifest |
| download interrupted: %w | error_code | error | go, network, download, disk-full, retry |
| size mismatch: got %d, expected %d (update runtime.json) | error_code | error | go, runtime-manifest, integrity, size-check, download |
| sha256 mismatch: got %s, want %s | error_code | critical | go, integrity, sha256, security, download |
| unsafe path in archive: %s | validation | critical | go, security, path-traversal, zip-slip, tar, extraction |
| extract runtime: %w | exception | error | go, extraction, disk-full, permissions, runtime-bootstrap |
| python runtime extracted but %s is missing | exception | error | go, runtime-bootstrap, python, layout-mismatch, antivirus |
| runtime.json: no platforms defined | validation | error | go, runtime-manifest, configuration, json |
| archive has no top-level directory | validation | error | go, zip, extraction, archive-layout |
| unsafe path in archive: %s | validation | critical | go, security, path-traversal, zip-slip, zip, extraction |
| no python executable found (runtime not downloaded?) | exception | error | |
| no embedded runtime archive for this platform (run fetch-pyt | exception | error | |
| open embedded archive: %w | exception | error | |
| read embedded archive: %w | exception | error | |
| extract embedded runtime: %w | exception | error | |
| pip install g4f failed (exit %d): %w | exception | error | |
| ensurepip failed (exit %d): %w | exception | error | |
| failed to query package manager: %w | exception | error | |
| android runtime present but runner missing; rerun g4f-go to | exception | error | |
| Termux is required to build the python runner (install com.t | exception | error | |
| pyandroid_runner.c missing: %w | exception | error | |
| clang build of pyandroid runner failed: %w | exception | error | |
| dlopen libpython3.14.so: %s\n | console | error | |
| missing python symbols: %s\n | console | error |