> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent max_budget

> Set a USD cap on agent spend via ExecutionConfig

<Warning>
  The top-level `Agent(max_budget=...)` shortcut was **removed** (PraisonAI PR #1642). Use `execution=ExecutionConfig(max_budget=...)` — see [CLI budget handling](/docs/features/cli-budget-handling).
</Warning>

Set a hard USD limit on agent runs with `ExecutionConfig`:

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent, ExecutionConfig

agent = Agent(
    name="Researcher",
    instructions="You research topics thoroughly",
    execution=ExecutionConfig(max_budget=0.50),
)

agent.start("Research the history of AI")
```

When the cap is exceeded, PraisonAI raises `BudgetExceededError` with the agent name and spend totals. The CLI surfaces a clean message — details in [CLI budget handling](/docs/features/cli-budget-handling).