litellm/docs/my-website/docs/tutorials
Ishaan Jaff 2ea9e207bd
Litellm ishaan march 20 (#24303)
* feat(redis): add circuit breaker to RedisCache to fast-fail when Redis is down (#24181)

* feat(redis): add circuit breaker env var constants

* feat(redis): add RedisCircuitBreaker and apply guard decorator to all async ops

* fix(dual_cache): fall back to L1 instead of re-raising on Redis increment failures

* test(caching): add circuit breaker unit tests

* fix(redis): fast-fail concurrent HALF_OPEN probes — only one probe at a time

* fix(dual_cache): return None fallback when in_memory_cache is absent and Redis fails

* test(caching): add regression tests for HALF_OPEN concurrency and None fallback

* Fix blocking sync next in __anext__ (#24177)

* Fix blocking sync next

* Update tests/test_litellm/litellm_core_utils/test_streaming_handler.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix PEP 479 regression in __anext__ sync iterator exhaustion

asyncio.to_thread re-raises thread exceptions inside a coroutine, where
PEP 479 converts StopIteration to RuntimeError before any except clause
can catch it. Add _next_sync_or_exhausted() module-level helper that
catches StopIteration in the thread and returns a sentinel instead, then
raise StopAsyncIteration in the coroutine.

Also rewrites the non-blocking test to use asyncio.gather() instead of
asyncio.create_task() (which returned None on Python 3.9 / pytest-asyncio
in CI), and adds an exhaustion regression test that drains the wrapper
fully and asserts no RuntimeError leaks out.

---------

Co-authored-by: Emerson Gomes <emerson.gomes@thalesgroup.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* feat: add git-subdir source type to claude-code/plugins API (#24223)

Support a third plugin source type `git-subdir` alongside the existing
`github` and `url` types, as documented in the official Claude Code
plugin marketplaces spec.

New format: {"source": "git-subdir", "url": "...", "path": "subdir/path"}

- Validates url and path fields are present and non-empty
- Rejects absolute paths, '..' segments, backslashes, and percent-encoded
  traversal sequences (including double-encoded variants via regex check)
- Extracts path validation into _validate_git_subdir_path() helper
- Updates Pydantic field description to document all three source types
- Adds isValidUrl() check for url/git-subdir source types in the UI form
- Adds "Git Subdir" option to the UI form with a required Path field
- Adds unit tests covering success, update, missing/empty fields,
  path traversal variants, and unknown source type

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

* [FEAT] add extract_header and extract_footer to Mistral OCR supported params (#24213)

* docs: add git-subdir source type to claude-code plugin marketplace docs (#24289)

* fix(ui): swap J/K keyboard navigation in log details drawer (#24279) (#24286)

J should navigate down (next) and K should navigate up (previous),
matching vim/standard conventions.

* fix: use async_set_cache in user_api_key_auth hot path (#24302)

* fix: use async_set_cache in auth hot path to avoid blocking event loop

* test: assert no blocking set_cache call in _user_api_key_auth_builder

* test: broaden blocking call check to all sync DualCache methods

* test: fix regression test to actually catch blocking cache calls

* fix: ruff lint unused variable + UI build MessageManager error

- litellm/caching/redis_cache.py: remove unused variable 'e' in circuit
  breaker exception handler (F841)
- add_plugin_form.tsx: use MessageManager.error() instead of undefined
  message.error() for git URL validation

Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>

* docs: add REDIS_CIRCUIT_BREAKER env vars to config_settings reference

Add REDIS_CIRCUIT_BREAKER_FAILURE_THRESHOLD and
REDIS_CIRCUIT_BREAKER_RECOVERY_TIMEOUT to the environment variables
reference table so test_env_keys.py passes.

Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>

---------

Co-authored-by: Emerson Gomes <emerson.gomes@thalesgroup.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Vincenzo Barrea <manamana88@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Robert Kirscht <rkirscht242@gmail.com>
Co-authored-by: Imgyu Kim <kimimgo@gmail.com>
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Ishaan Jaff <ishaan-jaff@users.noreply.github.com>
2026-03-21 12:40:11 -07:00
..
litellm_Test_Multiple_Providers_files updates to docs 2023-08-27 22:26:17 -07:00
anthropic_file_usage.md Litellm doc fixes 05 31 2025 (#11305) 2025-06-01 00:53:56 -07:00
azure_openai.md update docs 2023-09-14 10:47:40 -07:00
claude_agent_sdk.md [Docs] Claude Agents SDK x LiteLLM Guide (#20036) 2026-01-29 18:04:54 -08:00
claude_code_beta_headers.md Add support sync with remote URL for beta headers 2026-02-13 15:49:42 +05:30
claude_code_byok.md feat(proxy): client-side provider API key precedence for Anthropic /v1/messages 2026-03-06 18:20:46 +05:30
claude_code_customer_tracking.md [Docs Guide] Litellm claude code end user tracking (#19176) 2026-01-15 18:32:58 -08:00
claude_code_max_subscription.md Litellm cc docs max (#19466) 2026-01-20 20:08:36 -08:00
claude_code_plugin_marketplace.md Litellm ishaan march 20 (#24303) 2026-03-21 12:40:11 -07:00
claude_code_prompt_cache_routing.md feat: add support for anthropic_messages call type in prompt caching (#19233) 2026-02-07 22:51:06 -08:00
claude_code_skills.md docs: add Claude Code skills page for litellm-skills (#23642) 2026-03-14 13:24:16 -07:00
claude_code_websearch.md add img to doc 2026-01-17 18:05:16 -08:00
claude_mcp.md docs: fix Claude Code MCP tutorial with correct config and URL patterns (#21145) 2026-02-13 12:12:38 -08:00
claude_non_anthropic_models.md Litellm dev 01 15 2026 p1 (#19153) 2026-01-16 00:48:41 +05:30
claude_responses_api.md docs: update Claude Code integration guides (#19415) 2026-01-21 20:11:06 -08:00
compare_llms.md fix: update calendly on repo 2026-02-23 06:13:59 -08:00
compare_llms_2.md fix supported LLM on docs 2023-09-08 15:07:14 -07:00
copilotkit_sdk.md Apply suggestion from @greptile-apps[bot] 2026-02-04 11:56:17 +05:30
cost_tracking_coding.md docs fix 2025-08-02 16:47:44 -07:00
cursor_integration.md docs: add cursor with mcp 2026-01-18 06:51:09 +09:00
default_team_self_serve.md (Tutorial) Onboard Users for AI Exploration (#11955) 2025-06-21 16:54:23 -07:00
elasticsearch_logging.md docs: replace ghcr link with docker.litellm.ai 2025-12-16 08:35:45 +05:30
eval_suites.md Update MLflow calllback and documentation (#7809) 2025-01-21 20:56:48 -08:00
fallbacks.md Update docs/my-website/docs/tutorials/fallbacks.md 2026-03-02 16:03:55 -05:00
finetuned_chat_gpt.md Table format fix and Typo 2024-06-06 22:29:59 +09:30
first_playground.md (docs) litellm playground fix 2023-11-04 22:28:01 -07:00
gemini_realtime_with_audio.md LiteLLM Stable release notes (#10919) 2025-05-17 17:54:25 -07:00
github_copilot_integration.md Add Claude Code LiteLLM tutorial (#12650) 2025-07-16 23:07:29 -07:00
google_adk.md [Docs] Using litellm with Google ADK (#10777) 2025-05-12 16:41:49 -07:00
google_genai_sdk.md docs: add Google GenAI SDK tutorial (JS & Python) (#21885) 2026-02-23 09:20:46 -08:00
gradio_integration.md Fix typos (#10232) 2025-04-23 20:59:25 -07:00
huggingface_codellama.md update docs 2023-09-28 22:39:48 -07:00
huggingface_tutorial.md docs: add languages to code blocks 2023-09-12 15:02:11 -05:00
index.md docs: sidebar updates, letta resources links, Google GenAI SDK, cost tracking order 2026-03-18 04:28:06 +05:30
installation.md Refactor documentation structure and enhance content 2026-03-17 02:40:46 +05:30
instructor.md Update instructor.md (#10549) 2025-05-05 21:15:53 -07:00
litellm_gemini_cli.md Add Claude Code LiteLLM tutorial (#12650) 2025-07-16 23:07:29 -07:00
litellm_proxy_aporia.md Use the -d flag in docs instead of -D (#12179) 2025-06-30 15:25:42 -07:00
litellm_qwen_code_cli.md docs: add Qwen Code CLI tutorial (#12915) 2025-07-28 21:39:02 -07:00
litellm_Test_Multiple_Providers.md updates to docs 2023-08-27 22:26:17 -07:00
livekit_xai_realtime.md docs fix 2026-02-03 20:11:48 -08:00
lm_evaluation_harness.md Contributor PR - Support OPENAI_BASE_URL in addition to OPENAI_API_BASE (#9995) (#10423) 2025-04-29 21:27:37 -07:00
mock_completion.md docs 2023-09-15 12:35:16 -07:00
model_config_proxy.md docs(proxy_server.md): add logs, save keys, model fallbacks, config file template to proxy server docs 2023-10-14 10:52:01 -07:00
model_fallbacks.md (docs) get_max_tokens returns int not dict now 2023-11-17 10:39:13 -08:00
msft_sso.md docs: doc improvements 2025-10-08 18:59:00 -07:00
oobabooga.md add oobabooga tutorial docs 2023-09-27 21:27:57 -07:00
openai_agents_sdk.md Add OpenAI Agents SDK tutorial with LiteLLM Proxy to docs (#21221) 2026-02-23 12:10:01 -08:00
openai_codex.md docs: replace ghcr link with docker.litellm.ai 2025-12-16 08:35:45 +05:30
openclaw_integration.md docs: add OpenClaw integration tutorial (#21605) 2026-02-21 20:16:27 -08:00
opencode_integration.md adjust opencode tutorial (#19605) 2026-01-22 16:54:46 -08:00
openweb_ui.md Docs update on user header mapping (#14527) 2025-09-13 16:58:10 -07:00
presidio_pii_masking.md fix(guardrails): prevent presidio crash on non-json responses 2026-02-25 16:11:24 +05:30
prompt_caching.md [Fix] Anthropic cache_control incorrectly applied to all content items instead of last item only (#15699) 2025-10-18 15:18:08 -07:00
provider_specific_params.md docs(completion-docs): adds more details on provider-specific params 2023-10-07 13:49:30 -07:00
retool_assist.md Add Retool Assist tutorial with LiteLLM Proxy to docs (#21952) 2026-03-11 13:17:08 -07:00
scim_litellm.md Scim docs updated with user removal behavior 2025-09-08 09:20:00 -07:00
tag_management.md [Docs] v1.66.0-stable fixes (#9953) 2025-04-12 16:57:25 -07:00
text_completion.md add text_completion 2023-08-28 08:20:20 -07:00
TogetherAI_liteLLM.md docs - fix build time errors 2024-06-15 15:11:10 -07:00