ai-parrot-server

Server infrastructure for the AI-Parrot framework, extracted as a PEP 420 implicit namespace satellite package.

Overview

ai-parrot-server contributes server-side modules to the parrot.* namespace alongside the core ai-parrot package. All existing import paths remain unchanged — from parrot.handlers import ChatbotHandler works identically whether using the combined install or the split install.

What's Included

Module Contents
parrot.handlers ~59 aiohttp HTTP handler files (ChatbotHandler, BotHandler, etc.)
parrot.manager BotManager, EphemeralRegistry
parrot.services AgentService, delivery, heartbeat, worker pool, WhatsApp bridge, etc.
parrot.scheduler AgentSchedulerManager, schedule decorators, models, functions
parrot.autonomous AutonomousOrchestrator, transport layer (parrot-fs), deploy tools
parrot.mcp (server) MCPServer, MCPToolAdapter, MCPServerConfig, transports, CLI
parrot.a2a (server) A2AServer, A2AEnabledMixin, A2ASecurityMiddleware

Installation

# Core framework only (no server infrastructure)
pip install ai-parrot

# Core + all server infrastructure
pip install ai-parrot-server

# Core + server with specific extras
pip install ai-parrot-server[scheduler]    # + APScheduler
pip install ai-parrot-server[mcp]          # + MCP server transports (QUIC, gRPC)
pip install ai-parrot-server[a2a]          # + A2A server (JWT auth)
pip install ai-parrot-server[autonomous]   # + autonomous orchestrator (aiofiles)
pip install ai-parrot-server[all]          # everything

# Via host meta-extra
pip install ai-parrot[server]             # convenience alias for ai-parrot-server[all]
pip install ai-parrot[all]               # includes ai-parrot-server[all]

How It Works

This package uses PEP 420 implicit namespace packages. It contributes to the same parrot.* namespace as ai-parrot without any __init__.py files at the namespace levels. Python's import system merges the two distributions' directory trees transparently.

The host parrot.* __init__.py files use pkgutil.extend_path and lazy __getattr__ patterns to expose server classes when this satellite is installed, and provide helpful ImportError messages when it is not.

Migration

See docs/migration/feat-203-ai-parrot-server.md for the full migration guide.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.25.32)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for phenobarbital from gravatar.com phenobarbital

Credits

Author: Jesus Lara

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

scheduler mcp a2a autonomous all

Tags

ai agents server mcp a2a handlers scheduler autonomous

Classifiers

Report project as malware

Download files

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

Source Distribution

ai_parrot_server-0.25.31.tar.gz (525.6 kB view details)

Uploaded Source

Built Distribution

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

ai_parrot_server-0.25.31-py3-none-any.whl (572.2 kB view details)

Uploaded Python 3

File details

Details for the file ai_parrot_server-0.25.31.tar.gz.

File metadata

  • Download URL: ai_parrot_server-0.25.31.tar.gz
  • Upload date:
  • Size: 525.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ai_parrot_server-0.25.31.tar.gz
Algorithm Hash digest
SHA256 829659fb4d9e54e73431cbea11f759ef8bdece7c75bb33fd74f561e097a1eb5d
MD5 d7c992bb56ca75e12a99cb4b711522ed
BLAKE2b-256 d1b61ae0ce47fad3ae8f4b45c0fedd165895ac2d54ab3cb85adc5c429c57b51e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ai_parrot_server-0.25.31.tar.gz:

Publisher: release.yml on phenobarbital/ai-parrot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ai_parrot_server-0.25.31-py3-none-any.whl.

File metadata

File hashes

Hashes for ai_parrot_server-0.25.31-py3-none-any.whl
Algorithm Hash digest
SHA256 e29d234d7a574a1d071dd09771366fc69a059f705b4382b6c6aa22de44a01b28
MD5 936b56c189a0561adae58908f7c73676
BLAKE2b-256 3fb0b91991a4ddefb0c18951971d69c353414e421e272312ab3e2d48021f0236

See more details on using hashes here.

Provenance

The following attestation bundles were made for ai_parrot_server-0.25.31-py3-none-any.whl:

Publisher: release.yml on phenobarbital/ai-parrot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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