Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agno.com/llms.txt

Use this file to discover all available pages before exploring further.

"""
Cloudflare AI Gateway (basic)
=============================

Cookbook example for Cloudflare AI Gateway OpenAI-compatible unified API.

Requires:
- CLOUDFLARE_API_TOKEN
- CLOUDFLARE_ACCOUNT_ID

Optional:
- CLOUDFLARE_AI_GATEWAY_ID (defaults to the ``default`` gateway)

Default model is Workers AI (only Cloudflare token + account id). You can paste a
catalog binding: ``Agent(model="cloudflare:@cf/meta/llama-3.3-70b-instruct-fp8-fast")``,
the full gateway id, or ``Cloudflare()`` defaults.

For switching models (OpenRouter-style ``id`` string), see ``switch_model.py``.
"""

import asyncio

from agno.agent import Agent
from agno.models.cloudflare import Cloudflare

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

agent = Agent(
    model=Cloudflare("@cf/meta/llama-3.3-70b-instruct-fp8-fast"),
    markdown=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    # --- Sync ---
    agent.print_response("Share a 2 sentence horror story")

    # --- Sync + Streaming ---
    agent.print_response("Share a 2 sentence horror story", stream=True)

    # --- Async ---
    asyncio.run(agent.aprint_response("Share a 2 sentence horror story"))

    # --- Async + Streaming ---
    asyncio.run(agent.aprint_response("Share a 2 sentence horror story", stream=True))

Run the Example

# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno/cookbook/90_models/cloudflare

# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate

python basic.py