nagents 0.2.5

A lightweight, dependency-free LLM agent framework with direct HTTP-based provider integration

nagents

A lightweight LLM agent framework with direct HTTP-based provider integration.

Features

• Multi-Provider Support: OpenAI, Anthropic Claude, and Google Gemini APIs
• Streaming Events: Real-time text chunks, tool calls, and usage statistics
• Tool Execution: Register Python functions as tools with automatic schema generation
• Session Management: SQLite-based conversation persistence
• Batch Processing: Process multiple requests efficiently
• Minimal Dependencies: Only aiohttp and aiosqlite required

Installation

pip install nagents

Quick Start

import asyncio
from nagents import Agent, Provider, ProviderType

async def main():
    # Create a provider
    provider = Provider(
        provider_type=ProviderType.OPENAI_COMPATIBLE,
        api_key="your-api-key",
        model="gpt-4o-mini",
    )

    # Create an agent
    agent = Agent(provider=provider)

    # Run a conversation
    async for event in agent.run("Hello, how are you?"):
        if hasattr(event, 'chunk'):
            print(event.chunk, end="")

    await agent.close()

asyncio.run(main())

Providers

nagents supports three provider types:

Provider	Type	Models
OpenAI	ProviderType.OPENAI_COMPATIBLE	gpt-4o, gpt-4o-mini, etc.
Anthropic	ProviderType.ANTHROPIC	claude-3-5-sonnet, claude-3-opus, etc.
Google	ProviderType.GEMINI_NATIVE	gemini-2.0-flash, gemini-1.5-pro, etc.

With Tools

def get_weather(city: str) -> str:
    """Get the current weather for a city."""
    return f"Weather in {city}: Sunny, 22°C"

agent = Agent(
    provider=provider,
    tools=[get_weather],
)

async for event in agent.run("What's the weather in Paris?"):
    ...

With Session Persistence

from pathlib import Path
from nagents import SessionManager

session_manager = SessionManager(Path("sessions.db"))

agent = Agent(
    provider=provider,
    session_manager=session_manager,
)

# Use a specific session ID for conversation continuity
async for event in agent.run("Remember my name is Alice", session_id="user-123"):
    ...

Documentation

• Installation
• Quick Start
• Providers Guide
• Tools Guide
• API Reference

License

MIT