aitelier 0.1.0

An atelier for AI Agents.

aitelier 🎨🤖

An atelier for AI Agents running on your Mac thanks to mlx-llm.

Why aitelier?

aitelier is not just another agent library — it’s my personal playground to learn how AI agents work

• Learning by doing 🛠️: I want to understand every part of building AI agents. Instead of just using existing tools, I’m creating this library to figure out how things work from the ground up.

• Exploration, not duplication 🧐: aitelier isn’t meant to compete with other agent libraries. My goal is to learn, not to replace. Each update happens when I discover a new concept or method I want to explore.

• Deep understanding through practice 🧠: building from scratch helps me go beyond the surface. By recreating different paradigms, I can focus on truly understanding the details and improving my AI development skills.

aitelier will grow as I dive into new ideas and challenge myself to learn more. 🎯

I wrote an article about the motivation behind aitelier and how I implemented the first version of the library. You can read it here.

Supported Agents

• Simple Agent: A basic agent that takes a query and returns a response
• ReAct Agent: An agent the follows the Reasoning and Act paradigm paper

Simple Agent Example

from aitelier.model import LLM
from aitelier.agents import Agent
from aitelier.tool import Tool

@Tool
def multiply(a: float, b: float) -> float:
    return a * b

model = LLM("llama_3_2_3b_instruct")
agent = Agent(model=model, tools=[multiply])

agent("What is 3 multiplied by 4?")

ReAct Agent

The ReAct agent is a more advanced agent that follows the Reasoning and Act paradigm. The agent goes through the Think, Act, Observe states to produce the final answer based on a set of tools.

This is how you can use the ReAct Agent in aitelier:

from aitelier.model import LLM
from aitelier.agents import ReActAgent
from aitelier.tool import Tool

@Tool
def divide(a: float, b: float) -> float:
    if b == 0:
        return "Division by zero is not allowed"
    return a / b

model = LLM("llama_3_2_3b_instruct")
agent = ReActAgent(model=model, tools=[divide])

agent("What is 10 divided by 2?")

Supported Models

aitelier natively supports mlx-llm and Claude (with own API key)