Shekel: LLM budget control and AI agent cost governance for Python. Hard spend caps, loop detection, velocity limits, and distributed enforcement for OpenAI, Anthropic, LangGraph, CrewAI, and LiteLLM. One line, zero config.https://arieradle.github.io/shekel/1.1.0/ Arie Radlehttps://github.com/arieradle/shekelen Mon, 23 Mar 2026 18:53:43 -0000 Mon, 23 Mar 2026 18:53:43 -0000 1440 MkDocs RSS plugin - v1.17.9 None https://arieradle.github.io/shekel/1.1.0/ Browse Shekel documentation by topic. https://arieradle.github.io/shekel/1.1.0/tags/ Fri, 20 Mar 2026 09:35:47 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/tags/ budget-enforcement distributed rate-limiting redis Enforce shared LLM API spend limits atomically across multiple processes, workers, or Kubernetes pods. Atomic Lua-script enforcement, circuit breaker, fail-closed by default. https://arieradle.github.io/shekel/1.1.0/usage/distributed-budgets/ Thu, 19 Mar 2026 21:45:39 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/usage/distributed-budgets/ agent-frameworks budget-enforcement circuit-breaker openai openai-agents Enforce hard USD caps on OpenAI Agents SDK runners. Per-agent circuit breaking with b.agent(). AgentBudgetExceededError raised before the agent executes. Zero config. https://arieradle.github.io/shekel/1.1.0/integrations/openai-agents/ Thu, 19 Mar 2026 19:24:00 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/integrations/openai-agents/ agent-safety budget-enforcement circuit-breaker loop-detection runaway-agent tool-budgets Automatically detect and stop infinite tool-call loops before they drain your LLM budget. Per-tool rolling-window counter raises AgentLoopError before the tool executes. https://arieradle.github.io/shekel/1.1.0/usage/loop-guard/ Thu, 19 Mar 2026 19:24:00 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/usage/loop-guard/ agent-safety budget-enforcement circuit-breaker Cap how fast your AI agent spends money, not just how much. Stop a bursty agent that burns $40 in two minutes before your total USD cap fires. SpendVelocityExceededError. https://arieradle.github.io/shekel/1.1.0/usage/spend-velocity/ Thu, 19 Mar 2026 19:24:00 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/usage/spend-velocity/ architecture internals llm-guardrails production-ai Overview of shekel's internal architecture: budget enforcement lifecycle, provider adapter pattern, observability integrations, and CLI execution model. https://arieradle.github.io/shekel/1.1.0/architecture/ Mon, 16 Mar 2026 11:53:55 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/architecture/ architecture internals llm-guardrails Reference for shekel's core components: Budget, TemporalBudget, ContextVar, patching layer, pricing engine, tool tracker, CLI runner, and Redis backend. https://arieradle.github.io/shekel/1.1.0/architecture/components/ Mon, 16 Mar 2026 11:53:55 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/architecture/components/ architecture internals production-ai How shekel achieves thread safety and async safety: ContextVar isolation per thread and asyncio task, ref-counted patching with locks, and persistent budget caveats. https://arieradle.github.io/shekel/1.1.0/architecture/concurrency/ Mon, 16 Mar 2026 11:53:55 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/architecture/concurrency/ architecture cost-tracking internals llm-guardrails Step-by-step data flow through shekel: from LLM API call interception through token extraction, cost calculation, budget check, and spend recording. https://arieradle.github.io/shekel/1.1.0/architecture/data-flow/ Mon, 16 Mar 2026 11:53:55 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/architecture/data-flow/ architecture internals llm-guardrails production-ai How to extend shekel with new LLM provider adapters, custom observability backends, and additional pricing. Implement ProviderAdapter or ObservabilityAdapter. https://arieradle.github.io/shekel/1.1.0/architecture/extensibility/ Mon, 16 Mar 2026 11:53:55 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/architecture/extensibility/ architecture internals Complete map of the shekel Python package: every module, its purpose, and how the components connect. Reference for contributors and adapter authors. https://arieradle.github.io/shekel/1.1.0/architecture/module-map/ Mon, 16 Mar 2026 11:53:55 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/architecture/module-map/ architecture internals llm-guardrails High-level design of shekel: in-process monkey-patching, ContextVar isolation, ref-counted patching, provider adapter registry, and zero-config operation. https://arieradle.github.io/shekel/1.1.0/architecture/overview/ Mon, 16 Mar 2026 11:53:55 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/architecture/overview/ agent-safety budget-enforcement cli docker production-ai Enforce LLM spend limits on AI agents running in Docker containers. Use shekel run as an entrypoint wrapper. Set AGENT_BUDGET_USD at runtime — no rebuild required. https://arieradle.github.io/shekel/1.1.0/docker/ Sun, 15 Mar 2026 14:29:53 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/docker/ agent-safety budget-enforcement crewai langchain tool-budgets Enforce limits on AI agent tool dispatches. Cap total calls, charge per-tool USD, and auto-intercept LangChain, MCP, CrewAI, and OpenAI Agents SDK tools with zero config. https://arieradle.github.io/shekel/1.1.0/usage/tool-budgets/ Sun, 15 Mar 2026 10:19:42 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/usage/tool-budgets/ budget-enforcement distributed rate-limiting temporal-budgets Enforce per-hour, per-minute, or rolling-window LLM spend limits in Python. Multi-cap DSL, retry_after on exception, Redis backend for distributed rate limiting. https://arieradle.github.io/shekel/1.1.0/usage/temporal-budgets/ Sun, 15 Mar 2026 05:41:22 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/usage/temporal-budgets/ budget-enforcement cost-tracking llm-observability production-ai Export LLM cost, budget utilization, spend rate, fallback activations, and loop events via OpenTelemetry. Compatible with Prometheus, Grafana, Datadog, and any OTel backend. https://arieradle.github.io/shekel/1.1.0/integrations/otel/ Sat, 14 Mar 2026 21:49:09 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/integrations/otel/ budget-enforcement cost-tracking gemini llm-guardrails Enforce hard USD spend limits on Google Gemini API calls (Gemini 2.0 Flash, 2.5 Flash, 2.5 Pro). Hard caps, fallback models, nested budgets — zero SDK changes. https://arieradle.github.io/shekel/1.1.0/integrations/gemini/ Thu, 12 Mar 2026 16:17:48 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/integrations/gemini/ budget-enforcement cost-tracking llm-guardrails Enforce hard USD spend limits on HuggingFace Inference API calls. Hard caps, fallback models, and nested budgets for any model on the HuggingFace hub. https://arieradle.github.io/shekel/1.1.0/integrations/huggingface/ Thu, 12 Mar 2026 16:17:48 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/integrations/huggingface/ agent-frameworks budget-enforcement cost-tracking litellm Enforce hard spend limits across 100+ LLM providers through LiteLLM. Hard caps, fallback models, loop detection, and velocity limits — all via LiteLLMs unified interface. https://arieradle.github.io/shekel/1.1.0/integrations/litellm/ Thu, 12 Mar 2026 11:15:19 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/integrations/litellm/ <h1>CI/CD and Branch Protection</h1> <p>This document describes the CI/CD pipeline and branch protection settings for shekel.</p> <h2>CI Pipeline Overview</h2> <p>The CI pipelin...</p> https://arieradle.github.io/shekel/1.1.0/ci-and-branch-protection/ Wed, 11 Mar 2026 18:20:10 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/ci-and-branch-protection/