Basic Agent

Code

1from kern.agent import Agent, RunOutput # noqa
2from kern.models.neosantara import Neosantara
3
4agent = Agent(
5 model=Neosantara(id="grok-4.1-fast-non-reasoning"),
6 markdown=True,
7)
8
9# Get the response in a variable
10# run: RunOutput = agent.run("Share a 2 sentence horror story")
11# print(run.content)
12
13# Print the response in the terminal
14agent.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

Set your API key

1export NEOSANTARA_API_KEY=xxx

Install dependencies

1uv pip install -U openai kern-ai

Run Agent

1python cookbook/90_models/neosantara/basic.py