Cowbird: Middleware operation service

Cowbird (the brood parasite)

The brood parasite manipulates a host, either of the same or of another species, *to raise its young as if it were its own
The shiny cowbird is an obligate brood parasite, meaning that adults will lay their eggs in the nests of other species and their offspring rely entirely on their hosts for parental care.

Cowbird is a middleware that manages interactions between various birds of the bird-house stack.

It therefore relies on the existence of other services under a common architecture, but applies changes to the resources under those services such that the complete ecosystem can seamlessly operate together (see Components Diagram).


Requires Python 3.7+ Dependencies Status

build status

Readthedocs Build Status (master branch)

tests status

Github Actions CI Build Status (master branch) Github Actions CI Build Status (latest tag) Travis-CI CodeCov Coverage Codacy Badge

docker status

Docker Build Status (latest tag) Docker Build Status (latest tag)


Latest Tag Commits since latest release


The REST API documentation is auto-generated and served under {COWBIRD_URL}/api/ using Swagger-UI with tag latest.

More ample details about installation, configuration and usage are provided on readthedocs.
These are generated from corresponding information provided in docs.

Configuration and Usage

Multiple configuration options exist for Cowbird application.
Please refer to configuration for details.
See usage for details.

Change History

Addressed features, changes and bug fixes per version tag are available in CHANGES.

Docker Images

Following most recent variants are available:


Cowbird Base

Cowbird Worker

Cowbird Web Service

Most Recent Release




Latest Commit





Table of Contents

Indices and Tables