Dibba Logo

DIBBA

A Lightweight, Python-Native Orchestrator on Containerd and Calico

View on GitHub

What is Dibba?

If you've ever wished for Kubernetes-like primitives without the full weight of Kubernetes, Dibba is designed for you. It's a lightweight orchestration layer built in Python that focuses on the essentials: creating pods and containers, attaching networks, routing tasks to workers, and optionally spinning up worker nodes in the cloud.

🐳

Pods & Containers

Schedule and manage pods/containers using containerd 2.0 with resource hints and configurable namespaces.

🌐

Network Management

Attach network interfaces via Calico CNI with customizable network names and interfaces.

βš™οΈ

Task Distribution

Use Celery for distributed task execution with per-host routing and secure queue names.

πŸ’Ύ

State Management

Redis-backed messaging and state coordination for reliable operations.

☁️

Cloud Optional

Optionally provision AWS EC2 workers when you need them, or run on bare metal.

πŸ”’

Security First

OAuth2 password flow, JWT protection, and secure queue routing built-in.

Built on Proven Technologies

containerd 2.0

Industry-standard runtime

Calico CNI

Production networking

Celery

Distributed task queue

Redis

Fast state & messaging

FastAPI

Modern Python API

Protobuf

Typed contracts

# Get started with Dibba
$ pip install dibba

# Start the API server
$ uvicorn main_api:app --host 0.0.0.0 --port 8000

# Start a worker
$ celery -A dibba.worker worker --loglevel=info

# Get access token and create a pod
$ curl -X POST http://localhost:8000/token
$ curl -X POST http://localhost:8000/create-pod

Why Choose Dibba?

🎯 Minimal Surface Area

Keep the moving parts to what you needβ€”runtime, network, tasks. No unnecessary complexity.

🐍 Python-First

Write orchestration logic in Python, with an approachable codebase and extensible tasks.

🏭 Production-Minded

Namespaced runtime, secure queue routing, configurable network, and straightforward observability.

πŸš€ Cloud Optional

Works on bare metal or VMs. Add AWS EC2 worker provisioning only if you need it.

Who Is Dibba For?

🏒 Enterprise Teams

Teams needing focused container runtime and network orchestration without a full Kubernetes stack.

πŸ“‘ Edge Deployments

Edge deployments where simplicity and control matter more than feature breadth.

πŸ”§ Internal Platforms

Internal platforms that prefer Python for orchestration logic and rapid iteration.

⚑ Rapid Prototyping

Rapid prototyping for containerized services with a clear path to production.

Ready to Get Started?

Dibba aims to meet you where you are: Python tooling, containerd runtime, Calico networking, Redis messaging, and Celery tasks.

Read the Docs