<?xml version="1.0" encoding="UTF-8" ?> <?xml-stylesheet type="text/xsl" href="rss.xsl"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/"> <channel> <title>Shekel</title><description>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.</description><link>https://arieradle.github.io/shekel/1.2.0/</link><atom:link href="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml" rel="self" type="application/rss+xml" /> <managingEditor>Arie Radle</managingEditor><docs>https://github.com/arieradle/shekel</docs><language>en</language> <pubDate>Thu, 04 Jun 2026 10:04:34 -0000</pubDate> <lastBuildDate>Thu, 04 Jun 2026 10:04:34 -0000</lastBuildDate> <ttl>1440</ttl> <generator>MkDocs RSS plugin - v1.19.0</generator> <image> <url>None</url> <title>Shekel</title> <link>https://arieradle.github.io/shekel/1.2.0/</link> </image> <item> <title>Changelog</title> <category>agent-safety</category> <category>budget-enforcement</category> <category>llm-guardrails</category> <description>Full release history for shekel. Loop Guard, Spend Velocity, OpenAI Agents SDK circuit breaking, Redis distributed budgets, LangGraph/CrewAI/LangChain per-component caps, CLI.</description> <link>https://arieradle.github.io/shekel/1.2.0/changelog/</link> <pubDate>Thu, 04 Jun 2026 09:57:54 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/changelog/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/changelog.png" type="image/png" length="47900" /> </item> <item> <title>API Reference</title> <category>agent-safety</category> <category>budget-enforcement</category> <category>cost-tracking</category> <category>llm-guardrails</category> <description>Complete Python API reference for shekel: budget(), TemporalBudget, with_budget, @tool, all parameters, properties, methods, and the full exception hierarchy.</description> <link>https://arieradle.github.io/shekel/1.2.0/api-reference/</link> <pubDate>Thu, 04 Jun 2026 09:23:37 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/api-reference/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/api-reference.png" type="image/png" length="48701" /> </item> <item> <title>Distributed Budgets</title> <category>budget-enforcement</category> <category>distributed</category> <category>rate-limiting</category> <category>redis</category> <description>Enforce shared LLM API spend limits atomically across multiple processes, workers, or Kubernetes pods. Atomic Lua-script enforcement, circuit breaker, fail-closed by default.</description> <link>https://arieradle.github.io/shekel/1.2.0/usage/distributed-budgets/</link> <pubDate>Thu, 04 Jun 2026 09:23:37 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/usage/distributed-budgets/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/usage/distributed-budgets.png" type="image/png" length="51631" /> </item> <item> <title>Per-Tenant Budgets</title> <category>budget-enforcement</category> <category>multi-tenant</category> <category>per-tenant</category> <category>redis</category> <category>saas</category> <description>Enforce isolated per-user or per-tenant LLM spend limits in SaaS apps using shekel and Redis. Each tenant gets an independent cap — same backend, zero per-tenant config.</description> <link>https://arieradle.github.io/shekel/1.2.0/usage/per-tenant-budgets/</link> <pubDate>Thu, 04 Jun 2026 09:23:37 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/usage/per-tenant-budgets/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/usage/per-tenant-budgets.png" type="image/png" length="53644" /> </item> <item> <title>AutoGen Budget Control – Per-Agent Circuit Breaking</title> <category>agent-frameworks</category> <category>autogen</category> <category>budget-enforcement</category> <category>circuit-breaker</category> <category>microsoft</category> <description>Enforce LLM spend limits on AutoGen agents. Per-agent USD caps, global conversation budget, and tree-view cost breakdown. Zero changes to your agent code required.</description> <link>https://arieradle.github.io/shekel/1.2.0/integrations/autogen/</link> <pubDate>Thu, 04 Jun 2026 05:33:37 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/integrations/autogen/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/integrations/autogen.png" type="image/png" length="58799" /> </item> <item> <title>Home</title> <category>agent-safety</category> <category>anthropic</category> <category>budget-control</category> <category>budget-enforcement</category> <category>circuit-breaker</category> <category>cost-cap</category> <category>cost-tracking</category> <category>crewai</category> <category>getting-started</category> <category>langchain</category> <category>langgraph</category> <category>litellm</category> <category>openai</category> <category>spending-limit</category> <description>Open-source Python library for LLM budget control, token budgeting, and AI agent cost governance for OpenAI, Anthropic, LangChain, LangGraph, and modern LLMOps systems.</description> <link>https://arieradle.github.io/shekel/1.2.0/</link> <pubDate>Mon, 23 Mar 2026 18:52:18 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/index.png" type="image/png" length="49735" /> </item> <item> <title>Quick Start</title> <category>anthropic</category> <category>budget-control</category> <category>budget-enforcement</category> <category>circuit-breaker</category> <category>cost-cap</category> <category>cost-tracking</category> <category>getting-started</category> <category>openai</category> <category>spending-limit</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/quickstart/</link> <pubDate>Mon, 23 Mar 2026 18:52:18 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/quickstart/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/quickstart.png" type="image/png" length="50009" /> </item> <item> <title>Basic Usage</title> <category>anthropic</category> <category>budget-control</category> <category>budget-enforcement</category> <category>cost-cap</category> <category>cost-tracking</category> <category>getting-started</category> <category>openai</category> <category>spending-limit</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/usage/basic-usage/</link> <pubDate>Mon, 23 Mar 2026 18:52:18 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/usage/basic-usage/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/usage/basic-usage.png" type="image/png" length="56591" /> </item> <item> <title>Budget Enforcement</title> <category>ai-agent-guardrails</category> <category>budget-control</category> <category>budget-enforcement</category> <category>circuit-breaker</category> <category>cost-cap</category> <category>cost-tracking</category> <category>llm-guardrails</category> <category>spending-limit</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/usage/budget-enforcement/</link> <pubDate>Mon, 23 Mar 2026 18:52:18 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/usage/budget-enforcement/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/usage/budget-enforcement.png" type="image/png" length="53781" /> </item> <item> <title>Loop Guard</title> <category>agent-safety</category> <category>budget-enforcement</category> <category>circuit-breaker</category> <category>loop-detection</category> <category>runaway-agent</category> <category>tool-budgets</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/usage/loop-guard/</link> <pubDate>Mon, 23 Mar 2026 18:52:18 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/usage/loop-guard/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/usage/loop-guard.png" type="image/png" length="57632" /> </item> <item> <title>CLI Tools</title> <category>budget-enforcement</category> <category>cli</category> <category>docker</category> <category>getting-started</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/cli/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/cli/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/cli.png" type="image/png" length="48119" /> </item> <item> <title>Contributing</title> <category>getting-started</category> <description>Contribute to shekel, the open-source Python library for LLM budget control and AI agent cost governance. TDD required, 100% coverage, MIT license.</description> <link>https://arieradle.github.io/shekel/1.2.0/contributing/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/contributing/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/contributing.png" type="image/png" length="50936" /> </item> <item> <title>Docker &amp; Containers</title> <category>agent-safety</category> <category>budget-enforcement</category> <category>cli</category> <category>docker</category> <category>production-ai</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/docker/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/docker/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/docker.png" type="image/png" length="56575" /> </item> <item> <title>Extending Shekel</title> <category>architecture</category> <category>internals</category> <category>llm-guardrails</category> <category>production-ai</category> <description>Add new LLM providers, custom pricing, and observability backends to shekel. Implement ProviderAdapter or ObservabilityAdapter and register with the global registry.</description> <link>https://arieradle.github.io/shekel/1.2.0/extending/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/extending/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/extending.png" type="image/png" length="54552" /> </item> <item> <title>How It Works</title> <category>anthropic</category> <category>architecture</category> <category>internals</category> <category>openai</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/how-it-works/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/how-it-works/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/how-it-works.png" type="image/png" length="61275" /> </item> <item> <title>Installation</title> <category>anthropic</category> <category>budget-enforcement</category> <category>getting-started</category> <category>litellm</category> <category>openai</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/installation/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/installation/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/installation.png" type="image/png" length="55383" /> </item> <item> <title>Supported Models</title> <category>anthropic</category> <category>cost-tracking</category> <category>gemini</category> <category>litellm</category> <category>openai</category> <description>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.</description> <link>https://arieradle.github.io/shekel/1.2.0/models/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/models/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/models.png" type="image/png" length="52937" /> </item> <item> <title>Tags</title> <description>Browse Shekel documentation by topic.</description> <link>https://arieradle.github.io/shekel/1.2.0/tags/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/tags/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/tags.png" type="image/png" length="34911" /> </item> <item> <title>Introduction</title> <category>architecture</category> <category>internals</category> <category>llm-guardrails</category> <category>production-ai</category> <description>Overview of shekel&#39;s internal architecture: budget enforcement lifecycle, provider adapter pattern, observability integrations, and CLI execution model.</description> <link>https://arieradle.github.io/shekel/1.2.0/architecture/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/architecture/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/architecture/index.png" type="image/png" length="54865" /> </item> <item> <title>Core Components</title> <category>architecture</category> <category>internals</category> <category>llm-guardrails</category> <description>Reference for shekel&#39;s core components: Budget, TemporalBudget, ContextVar, patching layer, pricing engine, tool tracker, CLI runner, and Redis backend.</description> <link>https://arieradle.github.io/shekel/1.2.0/architecture/components/</link> <pubDate>Fri, 20 Mar 2026 10:05:21 +0000</pubDate> <source url="https://arieradle.github.io/shekel/1.2.0/feed_rss_updated.xml">Shekel</source><guid isPermaLink="true">https://arieradle.github.io/shekel/1.2.0/architecture/components/</guid> <enclosure url="https://arieradle.github.io/shekel/1.2.0assets/images/social/architecture/components.png" type="image/png" length="54394" /> </item> </channel> </rss>