Quickstart

Build and run your first agent in a few lines.

Get your first AI agent running in less than a minute.

Open the generated main.py file created by abz-agents setup, or create a new Python file and paste the following code.

main.py

from dotenv import load_dotenv
load_dotenv()

from abzagent import Agent, Memory

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant.",
    model="gemini-2.0-flash",
    memory=Memory(),
)

result = agent.run("What is the capital of France?")
print(result.content)

After that, run:

terminal

python main.py

If everything is configured correctly, you'll see a response like this:

Output

The capital of France is Paris.

🎉 Congratulations!

You've successfully built and executed your first AI agent using ABZ Agent SDK.

How It Works#

load_dotenv() loads your API key from .env so the SDK can authenticate with the model provider.
Agent(...) defines the assistant — its name, instructions, model, and a Memory instance to remember the conversation.
agent.run(...) sends your prompt to the model and returns a result object, with the reply available as result.content.

Next Step#

Continue to the Agents documentation to learn how agents work and how to customize them.