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 Aug 25, 2026
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.27.0)

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 Aug 25, 2026
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 comm-center 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.26.1.tar.gz (572.4 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.26.1-py3-none-any.whl (626.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ai_parrot_server-0.26.1.tar.gz
  • Upload date:
  • Size: 572.4 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.26.1.tar.gz
Algorithm Hash digest
SHA256 d47d9f65b0b7fdee2932243e570bb29196332ecae5d80fa75098d57e853c6aa2
MD5 79892d2f7a29a0a33c49713dbf564d44
BLAKE2b-256 5cb9e221272dcb39ddd974e97e97c88616414fb932674dceebde00ff93d4e9d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for ai_parrot_server-0.26.1.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.26.1-py3-none-any.whl.

File metadata

File hashes

Hashes for ai_parrot_server-0.26.1-py3-none-any.whl
Algorithm Hash digest
SHA256 758750eb294db30590a8885799dfca14e83d8f93b77c5babdbb41fa23e99b607
MD5 629906a329c39400ea8b0342d2b7e4f2
BLAKE2b-256 13cef314786b299c20e3c72e0b93a1c9b3dae100408fe1beee2177562a7248cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for ai_parrot_server-0.26.1-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.

Release history Release notifications | RSS feed

0.27.0

2 files

This release

0.26.1 This release

2 files

0.26.0

1 file

0.25.35

2 files

0.25.34

2 files

0.25.33

2 files

0.25.32

1 file

0.25.31

2 files

0.25.30

2 files

0.25.28

1 file

0.25.27

1 file

0.25.26

2 files

0.25.25

2 files

0.25.24

2 files

0.25.21

2 files

0.25.20

2 files

0.25.19

2 files

0.25.18

2 files

0.25.17

2 files

0.25.16

2 files

0.25.15

2 files

0.25.13

2 files

0.25.12

2 files

0.25.1

2 files

Supported by

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