pyagentic-core 1.0.0

Build LLM Agents in a Pythonic way

PyAgentic

A declarative framework for building AI agents with OpenAI integration. PyAgentic provides a clean, type-safe way to create intelligent agents using Python's metaclass system and modern async patterns.

Features

• Declarative Agent Definition - Define agents using simple class-based syntax
• Type Safety - Full typing support with Pydantic integration
• Tool Integration - Easy function decoration for agent capabilities
• Context Management - Sophisticated context handling with lifecycle management
• OpenAI Integration - Native support for OpenAI's API with automatic schema generation
• Async Support - Built-in async/await support for scalable applications
• Extensible - Clean architecture for custom tools, context types, and validations

🚀 Quick Start

Installation

pip install pyagentic-core

Basic Example

from pyagentic import Agent, tool, ContextItem
from typing import List

class WeatherAgent(Agent):
    """An agent that provides weather information."""
    
    location: str = ContextItem(description="Current location")
    
    @tool
    def get_weather(self, city: str) -> str:
        """Get current weather for a city."""
        # Your weather API logic here
        return f"The weather in {city} is sunny and 75°F"
    
    @tool
    def get_forecast(self, city: str, days: int = 5) -> List[str]:
        """Get weather forecast for multiple days."""
        return [f"Day {i+1}: Partly cloudy" for i in range(days)]

# Create and use the agent
agent = WeatherAgent(location="San Francisco")
response = await agent.run("What's the weather like in New York?")
print(response)

Project Structure

pyagentic/
├── pyagentic/           # Core framework code
│   ├── _base/           # Internal implementation
│   └── __init__.py      # Public API
├── tests/               # Test suite
│   ├── _base/           # Core tests
│   ├── integration/     # Integration tests
│   └── performance/     # Performance tests
├── examples/            # Example agents
├── templates/           # Agent templates
├── docs/                # Documentation
├── scripts/             # Utility scripts
└── notebooks/           # Jupyter notebooks

Contributing

Contributions are welcome! Details coming soon.

Development Setup

# Install dependencies
uv sync --group dev

# Formatting
uv run black -l99 pyagentic

# Linting
uv run flake8 --max-line-length 99 pyagentic

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.