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/ agent-safety anthropic budget-control budget-enforcement circuit-breaker cost-cap cost-tracking crewai getting-started langchain langgraph litellm openai spending-limit Open-source Python library for LLM budget control, token budgeting, and AI agent cost governance for OpenAI, Anthropic, LangChain, LangGraph, and modern LLMOps systems. https://arieradle.github.io/shekel/1.1.0/ Mon, 23 Mar 2026 18:52:18 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/ anthropic budget-control budget-enforcement circuit-breaker cost-cap cost-tracking getting-started openai spending-limit Enforce LLM API spend limits in Python in 5 minutes. Hard caps, early warnings, fallback models, nested budgets, loop detection, and CLI enforcement — zero config. https://arieradle.github.io/shekel/1.1.0/quickstart/ Mon, 23 Mar 2026 18:52:18 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/quickstart/ anthropic budget-control budget-enforcement cost-cap cost-tracking getting-started openai spending-limit Track LLM API spend and enforce hard USD caps with one line of Python. Works with OpenAI, Anthropic, LiteLLM, and any framework that calls them. No API keys, no setup. https://arieradle.github.io/shekel/1.1.0/usage/basic-usage/ Mon, 23 Mar 2026 18:52:18 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/usage/basic-usage/ ai-agent-guardrails budget-control budget-enforcement circuit-breaker cost-cap cost-tracking llm-guardrails spending-limit Enforce LLM API spending limits with hard USD caps, soft warnings at configurable thresholds, warn-only mode, and custom callbacks. Full control over how budgets fire. https://arieradle.github.io/shekel/1.1.0/usage/budget-enforcement/ Mon, 23 Mar 2026 18:52:18 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/usage/budget-enforcement/ 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/ Mon, 23 Mar 2026 18:52:18 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/usage/loop-guard/ agent-safety budget-enforcement cost-tracking llm-guardrails Complete Python API reference for shekel: budget(), TemporalBudget, with_budget, @tool, all parameters, properties, methods, and the full exception hierarchy. https://arieradle.github.io/shekel/1.1.0/api-reference/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/api-reference/ agent-safety budget-enforcement llm-guardrails Full release history for shekel. Loop Guard, Spend Velocity, OpenAI Agents SDK circuit breaking, Redis distributed budgets, LangGraph/CrewAI/LangChain per-component caps, CLI. https://arieradle.github.io/shekel/1.1.0/changelog/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/changelog/ budget-enforcement cli docker getting-started Run any Python agent under a hard LLM budget from the command line with no code changes. CI-friendly exit codes, Docker support, GitHub Actions, JSON output, env-var budgets. https://arieradle.github.io/shekel/1.1.0/cli/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/cli/ getting-started Contribute to shekel, the open-source Python library for LLM budget control and AI agent cost governance. TDD required, 100% coverage, MIT license. https://arieradle.github.io/shekel/1.1.0/contributing/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/contributing/ 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/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/docker/ architecture internals llm-guardrails production-ai Add new LLM providers, custom pricing, and observability backends to shekel. Implement ProviderAdapter or ObservabilityAdapter and register with the global registry. https://arieradle.github.io/shekel/1.1.0/extending/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/extending/ anthropic architecture internals openai How shekel intercepts LLM API calls using monkey-patching, tracks spend per-context with Python ContextVar for thread and async safety, and enforces hard caps with zero configuration. https://arieradle.github.io/shekel/1.1.0/how-it-works/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/how-it-works/ anthropic budget-enforcement getting-started litellm openai Install shekel for LLM API budget enforcement in Python. Zero external dependencies, no API keys, no config. Supports OpenAI, Anthropic, LiteLLM, Gemini, HuggingFace, and more. https://arieradle.github.io/shekel/1.1.0/installation/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/installation/ anthropic cost-tracking gemini litellm openai Built-in pricing for GPT-4o, o1, o3, Claude 3.5/3/3.7, Gemini 2.0/2.5, and more. Install shekel[all-models] for 400+ models via tokencost. https://arieradle.github.io/shekel/1.1.0/models/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/models/ Browse Shekel documentation by topic. https://arieradle.github.io/shekel/1.1.0/tags/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/tags/ 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/ Fri, 20 Mar 2026 10:05:21 +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/ Fri, 20 Mar 2026 10:05:21 +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/ Fri, 20 Mar 2026 10:05:21 +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/ Fri, 20 Mar 2026 10:05:21 +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/ Fri, 20 Mar 2026 10:05:21 +0000 Shekelhttps://arieradle.github.io/shekel/1.1.0/architecture/extensibility/