Basic

Code

1from kern.agent import Agent, RunOutput  # noqa
2from kern.models.ollama import Ollama
3
4agent = Agent(model=Ollama(id="llama3.1:8b"), markdown=True)
5
6# Get the response in a variable
7# run: RunOutput = agent.run("Share a 2 sentence horror story")
8# print(run.content)
9
10# Print the response in the terminal
11agent.print_response("Share a 2 sentence horror story")

Usage

Set up your virtual environment

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

1uv venv --python 3.12
2.venv\Scripts\activate

Install Ollama

Follow the Ollama installation guide and run:

1ollama pull llama3.1:8b

Install dependencies

1uv pip install -U ollama kern-ai

Run Agent

1python cookbook/11_models/ollama/basic.py

Cloud Alternative

For easier setup without local installation, you can use Ollama Cloud with your API key:

1from kern.agent import Agent
2from kern.models.ollama import Ollama
3
4# No local setup required - just set OLLAMA_API_KEY
5agent = Agent(model=Ollama(id="gpt-oss:120b-cloud", host="https://ollama.com"))
6agent.print_response("Share a 2 sentence horror story")