Skip to main content

Simplify the Complex, Amplify the Intelligent for Enterprise. Orchestrate multiple agents with ease: register agents, integrate tools, define custom instructions, and leverage multiple models.

Project description

AgentRouter SDK

Simplify the Complex, Amplify the Intelligent for Enterprise

Orchestrate multiple agents with ease: register agents, integrate tools, define custom instructions, and leverage multiple models. Enterprise-grade and production-ready, with full control, deep customization, strong defaults, clear boundaries, and developer-focused APIs.

๐Ÿ“š Full Documentation: https://agents-docs.us.inc

Overview

AgentRouter is an enterprise-grade, production-ready framework that provides:

  • ๐Ÿ—๏ธ Hierarchical Agent Management - Create manager and worker agents with unlimited nesting
  • ๐Ÿ”ง Tool Integration - Easy tool creation with OpenAI-compatible schemas
  • ๐Ÿš€ Enterprise-Ready - Built-in error handling, logging, and monitoring
  • ๐Ÿ”’ Complete Isolation - Full isolation between agent instances
  • ๐Ÿค OpenAI Compatible - Works seamlessly with OpenAI message formats
  • ๐Ÿ“Š Visual Tracing - Zero-overhead tracing with beautiful execution visualizations

Why AgentRouter?

๐ŸŽฏ Purpose-Built for Enterprise Scale

Unlike generic agent frameworks, AgentRouter is designed from the ground up for production environments handling millions of requests daily. Every architectural decision prioritizes reliability, performance, and maintainability.

๐Ÿ”„ True Hierarchical Management

While other frameworks offer basic agent coordination, AgentRouter provides unlimited nesting depth with intelligent message routing, automatic context propagation, and seamless worker sharing across multiple managers.

๐Ÿ’ก Key Differentiators

1. Complete Agent Isolation

  • Each agent instance is fully isolated with no state leakage
  • Concurrent execution without interference
  • Secure multi-tenant deployments

2. Shared Worker Pattern

  • Reuse specialized workers across multiple managers
  • Reduce resource consumption and API costs
  • Maintain consistency across workflows

3. Intelligent Configuration Inheritance

  • Workers automatically inherit parent configurations
  • Override specific settings when needed
  • Centralized credential management

4. Production-Grade Features

  • Built-in retry mechanisms and circuit breakers
  • Comprehensive error handling and recovery
  • Structured logging and monitoring hooks
  • Configurable timeouts at every level

5. Zero-Overhead Tracing

  • Performance profiling adds < 1ns when disabled
  • Beautiful visualization of execution flows
  • Export to multiple formats (Mermaid, HTML, JSON)

6. OpenAI Drop-in Compatibility

  • Use existing OpenAI code with minimal changes
  • Enhanced with multi-agent capabilities
  • Support for any OpenAI-compatible model provider

๐Ÿ“Š When to Choose AgentRouter

โœ… Perfect for:

  • Complex multi-department workflows
  • Applications requiring agent specialization
  • Systems needing audit trails and compliance
  • High-volume production deployments
  • Teams wanting gradual migration from OpenAI

๐Ÿ“– Learn more about our architecture โ†’

Key Features

๐Ÿ—๏ธ Hierarchical Multi-Agent System

  • Unlimited nesting depth for complex workflows
  • Shared worker agents across multiple parents
  • Dynamic agent creation and attachment

๐Ÿ”ง Tool Integration

  • OpenAI-compatible function schemas
  • Automatic validation and error handling
  • Support for async operations

๐Ÿš€ Production Ready

  • Configurable timeouts and retries
  • Built-in monitoring and logging
  • Scale to millions of users per day

๐Ÿ“Š Visualization & Tracing

  • Zero-overhead tracing (< 1ns when disabled)
  • Multiple output formats: Mermaid, HTML, JSON
  • Pipeline validation before execution

Installation

pip install agentrouter

Quick Start

from agentrouter import ManagerAgent, WorkerAgent, tool

# Create a manager agent
manager = ManagerAgent(
    name="Customer_Service_Manager",
    model="usf-mini",
    api_key="your-api-key"
)

# Create and attach workers
tech_support = manager.create_worker(
    name="Technical_Support",
    role="Technical Support Specialist"
)

# Execute tasks
messages = [{"role": "user", "content": "Help needed"}]
response = await manager.execute(messages)

๐Ÿ“– View Complete Quick Start Guide โ†’

Documentation

Getting Started

Architecture & Concepts

Examples & Cookbook

Advanced Topics

๐Ÿ“‚ Browse All Examples โ†’

๐Ÿ“– Development Guide โ†’

License

AgentRouter SDK is licensed under the Permissive Commercial Use License. See the LICENSE file for full details.

โœ… You are free to:

  • Use AgentRouter for ANY commercial purpose
  • Build commercial applications and services with AgentRouter
  • Deploy AgentRouter in production environments
  • Integrate AgentRouter into your products
  • Use AgentRouter for research and development

โŒ You cannot:

  • Create competing orchestration frameworks based on AgentRouter's code
  • Fork and modify AgentRouter to create competitive products
  • Use AgentRouter's source code as inspiration for competitive products

For additional support or custom licensing arrangements, please contact the UltraSafe AI Team at support@us.inc.


Visit Full Documentation โ†’

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentrouter-0.0.1b10.tar.gz (110.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentrouter-0.0.1b10-py3-none-any.whl (105.8 kB view details)

Uploaded Python 3

File details

Details for the file agentrouter-0.0.1b10.tar.gz.

File metadata

  • Download URL: agentrouter-0.0.1b10.tar.gz
  • Upload date:
  • Size: 110.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for agentrouter-0.0.1b10.tar.gz
Algorithm Hash digest
SHA256 fd706dc01156e9470ca4c995c691126bacc00546989919c8e7d96f0cef799156
MD5 876eeea67283571d2b89c596a3a176db
BLAKE2b-256 168efac4772dba44333d9bc8e3f6045395f0928604bcbbadfda06de26c4d1be6

See more details on using hashes here.

File details

Details for the file agentrouter-0.0.1b10-py3-none-any.whl.

File metadata

  • Download URL: agentrouter-0.0.1b10-py3-none-any.whl
  • Upload date:
  • Size: 105.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for agentrouter-0.0.1b10-py3-none-any.whl
Algorithm Hash digest
SHA256 c406a83efb371b813f9b4e0789cadcac1a99646e14c0e2113e47fbd98f445076
MD5 710cd1f68ad3b56a634efb851f2491a6
BLAKE2b-256 09121208e01377967923c733bba652a0aa78f0301b0af36b8b5213e09d85425c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page