Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.timbal.ai/llms.txt

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

Agents automatically handle image files when included in prompts. First validate your image file with Timbal’s File type, then pass it alongside text in a list: 
from timbal import Agent
from timbal.types.file import File

agent = Agent(
    name="VisionAgent",
    model="anthropic/claude-3-7-sonnet-latest",  # Vision-capable model
    max_tokens=256,
    system_prompt="Analyze images and provide detailed descriptions."
)

# Validate multiple image files and analyze
image1 = File.validate("path/to/image1.jpg")
image2 = File.validate("path/to/image2.png")
image3 = File.validate("path/to/image3.jpeg")

result = await agent(
    prompt=["Analyze these images and provide a description of each one", image1, image2, image3]
).collect()

print(result.output.collect_text())
Use vision-capable models for image processing. Check Model Capabilities to see which models support image input.

​
Key Features

  • Automatic Processing: Images are automatically converted to the correct format for vision models
  • Multi-modal: Combine text and images in the same conversation
  • File Support: Works with local files, URLs, and base64 data