Image Input File Upload

Migrate the v2.7.4 Anthropic image upload example to a supported model and local image input.

Preserve the released Files API source, then apply the required model and image-input changes before running it.

The source passes an Anthropic uploaded FileMetadata object to Image.content, which accepts bytes in Agno v2.7.4. Use the downloaded local file path directly before running. Anthropic retired claude-opus-4-20250514 on June 15, 2026. Replace it with claude-opus-4-8 before running. See Claude model deprecations.

image_input_file_upload.py

"""
In this example, we upload a PDF file to Anthropic directly and then use it as an input to an agent.
"""

from pathlib import Path

from agno.agent import Agent
from agno.media import Image
from agno.models.anthropic import Claude
from agno.utils.media import download_file
from anthropic import Anthropic

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

img_path = Path(__file__).parent.joinpath("agno-intro.png")

# Download the file using the download_file function
download_file(
    "https://agno-public.s3.us-east-1.amazonaws.com/images/agno-intro.png",
    str(img_path),
)

# Initialize Anthropic client
client = Anthropic()

# Upload the file to Anthropic
uploaded_file = client.beta.files.upload(
    file=Path(img_path),
)

if uploaded_file is not None:
    agent = Agent(
        model=Claude(
            id="claude-opus-4-20250514",
            betas=["files-api-2025-04-14"],
        ),
        markdown=True,
    )

    agent.print_response(
        "What does the attached image say.",
        images=[Image(content=uploaded_file)],
    )

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    pass

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno anthropic
   
3. Export your Anthropic API key

   Mac/Linux

   export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
   

   $Env:ANTHROPIC_API_KEY="your_anthropic_api_key_here"
   
4. Update the Claude model

   Replace claude-opus-4-20250514 with claude-opus-4-8 in the saved file.

5. Use the local image directly

   Remove the direct Anthropic client import and the Files API upload block. Replace Image(content=uploaded_file) with Image(filepath=img_path) and run the agent without the if uploaded_file is not None wrapper.

6. Run the example

   Save the code above as image_input_file_upload.py, then run:

   python image_input_file_upload.py
   

Full source: cookbook/90_models/anthropic/image_input_file_upload.py