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
`parrot.server.ui`	Embedded Admin UI (`setup_admin_ui()`, `/admin`) — login, status dashboard, read-only agent inventory. See `docs/admin-ui.md`.

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.

Metadata

Release files for ai-parrot-server 1.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ai-parrot-server 1.3.2
File	Size	Uploaded
ai_parrot_server-1.3.2.tar.gz	4.9 MB	Oct 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ai-parrot-server 1.3.2
File	Interpreter	ABI	Platform	Reset
ai_parrot_server-1.3.2-py3-none-any.whl 5.0 MB Oct 16, 2026	Python 3	none	any	Details

Total release size: 9.9 MB

Release files / ai_parrot_server-1.3.2.tar.gz

Download URL	ai_parrot_server-1.3.2.tar.gz
Size	4.9 MB
Tags	Source
SHA-256 checksum How to use checksums	`1ef1aab763eeb2a709605887f251f449ec9d011f9cfbf2fe34f23b6eb80e3215`
BLAKE2b-256 checksum How to use checksums	`625e9655b9f414ff99b26c7c694f8310a0a59bcff6ad688a4048b1f73bc1938f`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/phenobarbital/ai-parrot
Publishing commit: github.com/phenobarbital/ai-parrot/tree/22b0c4ed75a07105a3a8c12d09dbb056ba94c9b1

Workflow

Publishing configuration: github.com/phenobarbital/ai-parrot/blob/22b0c4ed75a07105a3a8c12d09dbb056ba94c9b1/.github/workflows/release.yml
Publishing logs: github.com/phenobarbital/ai-parrot/actions/runs/38831313265/attempts/1

Artifact

Subject: ai_parrot_server-1.3.2.tar.gz
SHA-256 checksum: 1ef1aab763eeb2a709605887f251f449ec9d011f9cfbf2fe34f23b6eb80e3215 Verifying attestations

Release files / ai_parrot_server-1.3.2-py3-none-any.whl

Download URL	ai_parrot_server-1.3.2-py3-none-any.whl
Size	5.0 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`643cb2f60986b9c6bb508c24c2e3c1dcac6c2f69e22b080ad48bdfea22d97920`
BLAKE2b-256 checksum How to use checksums	`da41dc9f9fce5b6bd86c10eb01523f6f7afa7c1bf54b1e0814b55753ab66def2`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/phenobarbital/ai-parrot
Publishing commit: github.com/phenobarbital/ai-parrot/tree/22b0c4ed75a07105a3a8c12d09dbb056ba94c9b1

Workflow

Publishing configuration: github.com/phenobarbital/ai-parrot/blob/22b0c4ed75a07105a3a8c12d09dbb056ba94c9b1/.github/workflows/release.yml
Publishing logs: github.com/phenobarbital/ai-parrot/actions/runs/38831313265/attempts/1

Artifact

Subject: ai_parrot_server-1.3.2-py3-none-any.whl
SHA-256 checksum: 643cb2f60986b9c6bb508c24c2e3c1dcac6c2f69e22b080ad48bdfea22d97920 Verifying attestations