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

# heartbeat • AI Agent SDK

> Heartbeat — runs an agent on a schedule, delivers results via callback.

# heartbeat

<Badge color="blue">AI Agent</Badge>

Heartbeat — runs an agent on a schedule, delivers results via callback.

Standalone wrapper class. Does NOT modify the Agent class.

Usage::

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

agent = Agent(instructions="Check server status")
hb = Heartbeat(agent, schedule="every 30m", prompt="Report status")
hb.start()   # blocking loop
# hb.start(blocking=False)  # background thread
```

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents.agent import heartbeat
```

## Classes

<CardGroup cols={2}>
  <Card title="HeartbeatConfig" icon="brackets-curly" href="../classes/HeartbeatConfig">
    Configuration for Heartbeat scheduler.
  </Card>

  <Card title="Heartbeat" icon="brackets-curly" href="../classes/Heartbeat">
    Standalone heartbeat coordinator.
  </Card>
</CardGroup>