> ## 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

AI Agent

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

> [card] [HeartbeatConfig](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/HeartbeatConfig.md)
>
> Configuration for Heartbeat scheduler.

> [card] [Heartbeat](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/Heartbeat.md)
>
> Standalone heartbeat coordinator.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.