Usage

Basic Agent

Run a WatsonX agent and print its response.

Code

from agno.agent import Agent, RunOutput
from agno.models.ibm import WatsonX

agent = Agent(
    model=WatsonX(id="mistralai/mistral-small-3-1-24b-instruct-2503"), markdown=True
)

# Get the response in a variable
# run: RunOutput = agent.run("Share a 2 sentence horror story")
# print(run.content)

# Print the response in the terminal
agent.print_response("Share a 2 sentence horror story")

Usage

Set up your virtual environment

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

Set your API key

export IBM_WATSONX_API_KEY=xxx
export IBM_WATSONX_PROJECT_ID=xxx

Install dependencies

uv pip install -U ibm-watsonx-ai agno

Run Agent

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

python basic.py

Setting markdown=True formats the agent's response as markdown.

Overview

Use IBM WatsonX foundation models with Agno agents.

Streaming Basic Agent

Stream a WatsonX agent's response with stream=True.