artificer-agents 0.1.0a2

A library for creating agents

artificer-agents

A lightweight Python library for running deterministic agent loops with MCP tools.

Installation

pip install artificer-agents

# With OpenAI support
pip install artificer-agents[openai]

Requires Python 3.13+.

Usage

import asyncio
from pydantic import BaseModel
from artificer.agents import Agent, run_agent
from artificer.mcp import MCPClient
from artificer.models import OpenAIModel

class Input(BaseModel):
    query: str

class Output(BaseModel):
    result: str

agent = Agent(
    name="my-agent",
    system_prompt="You are a helpful assistant.",
    input_schema=Input,
    output_schema=Output,
)

async def main():
    model = OpenAIModel(model="gpt-4o-mini")
    async with MCPClient(["path/to/mcp-server.py"]) as mcp:
        result = await run_agent(agent, Input(query="Hello"), model=model, mcp_client=mcp)
        print(result.output)

asyncio.run(main())

Development

uv sync                    # Install dependencies
./scripts/check.sh         # Run all checks (lint, format, typecheck, tests)
./scripts/test.sh          # Run tests only
./scripts/format.sh        # Format code

License

MIT