servants 0.1.7

A simple library for prototyping and learning agent-based reasoning with tools.

servants

A simple Python library for prototyping and learning agent-based reasoning with tools.

This package helps you quickly prototype agent architectures that use tools (functions) and step-by-step reasoning. It is designed for educational and experimental purposes, not for production use.

Installation

pip install servants

Usage

from servants import Tool

def get_weather(city: str) -> str:
    """Gets the current weather for a given city."""
    if "london" in city.lower():
        return "Rainy"
    elif "paris" in city.lower():
        return "Sunny"
    else:
        return "Cloudy"

tool = Tool(get_weather, "get_weather", "A tool to get the current weather for a city.")
schema = tool.build_tool_schema()
print(schema)

What does it do?

• Automatically generates a JSON schema for any Python function's parameters and types.
• Makes it easy to describe agent tools and methods for LLMs or other automation systems.
• Minimal, easy-to-use API.

Note

This library is intended for prototyping and learning. For production-grade agent frameworks, see LangChain or similar projects.