# `ElixirLLM.RateLimiter`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L1)

Token bucket rate limiter for LLM API calls.

Provides client-side rate limiting to prevent hitting provider rate limits.
Uses ETS for efficient concurrent access.

## Configuration

    config :elixir_llm, :rate_limiter,
      enabled: true,
      openai: [requests_per_minute: 60],
      anthropic: [requests_per_minute: 50],
      openrouter: [requests_per_minute: 100],
      ollama: [requests_per_minute: 1000]

## Example

    # Wait for a token before making a request
    :ok = ElixirLLM.RateLimiter.acquire(:openai)

    # Non-blocking check
    case ElixirLLM.RateLimiter.try_acquire(:openai) do
      :ok -> # proceed
      {:error, :rate_limited} -> # handle rate limiting
    end

    # Check remaining tokens
    tokens = ElixirLLM.RateLimiter.available(:openai)

# `provider`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L48)

```elixir
@type provider() :: atom()
```

# `acquire`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L67)

```elixir
@spec acquire(provider(), timeout()) :: :ok
```

Acquires a token for the given provider, blocking if necessary.

Returns `:ok` when a token is available.

# `available`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L121)

```elixir
@spec available(provider()) :: non_neg_integer()
```

Returns the number of available tokens for a provider.

# `child_spec`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L32)

Returns a specification to start this module under a supervisor.

See `Supervisor`.

# `reset`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L136)

```elixir
@spec reset(provider()) :: :ok
```

Resets the rate limiter for a provider.

# `reset_all`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L149)

```elixir
@spec reset_all() :: :ok
```

Resets all rate limiters.

# `start_link`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L57)

Starts the rate limiter.

# `try_acquire`
[🔗](https://github.com/khasinski/elixir_llm/blob/v0.3.0/lib/elixir_llm/rate_limiter.ex#L97)

```elixir
@spec try_acquire(provider()) :: :ok | {:error, :rate_limited}
```

Attempts to acquire a token without blocking.

Returns `:ok` if successful, `{:error, :rate_limited}` otherwise.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
