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.1b6.tar.gz (105.3 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.1b6-py3-none-any.whl (102.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentrouter-0.0.1b6.tar.gz
  • Upload date:
  • Size: 105.3 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.1b6.tar.gz
Algorithm Hash digest
SHA256 00a75c630d344c6cdd67e4c57af1683f7023a55267fc9d849a314c5b610244a6
MD5 22d3aca030a32684a3dbb13872314083
BLAKE2b-256 91ee05dc665ae93bc18c0a7c1a7d78a797329be0b99f88dc1e1abe2981756560

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agentrouter-0.0.1b6-py3-none-any.whl
  • Upload date:
  • Size: 102.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.1b6-py3-none-any.whl
Algorithm Hash digest
SHA256 e2b008538d9ad4a32366af885ff73e41a85c8b151c5c2dc6076323678493521b
MD5 46191cd3a8c3beee41fbf4aba463b226
BLAKE2b-256 d131a00b1a42d054254c0c24e724e011b9b6b3d4fed6578c736b8f1169c2131f

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