project-planton

README

Project Planton

Deploy anywhere with one workflow. Write declarative YAML once, deploy to AWS, GCP, Azure, or Kubernetes with the same CLI and consistent experience.

What is Project Planton?

An open-source multi-cloud deployment framework that brings Kubernetes-style consistency to infrastructure deployments everywhere. No vendor lock-in, no artificial abstractions—just provider-specific configurations with a unified structure and workflow.

Documentation · Component Catalog · Website

---

Why Project Planton?

• One structure, any cloud - Kubernetes Resource Model (apiVersion/kind/metadata/spec) for all deployments
• Validate before deploy - Protocol Buffer validations catch errors in seconds, not minutes
• Zero abstraction - Provider-specific configs preserve cloud capabilities, consistent experience across all
• Choose your IaC - Built-in Pulumi and Terraform/OpenTofu modules with feature parity
• Build on top - Auto-generated SDKs in Go, Python, TypeScript, Java from Protocol Buffer definitions

---

Quick Start

1. Install the CLI

brew install plantonhq/tap/project-planton

2. Create a YAML Manifest

Example: Deploy Redis to Kubernetes using the redis-kubernetes deployment component.

apiVersion: kubernetes.project-planton.org/v1
kind: RedisKubernetes
metadata:
  name: payments
  id: payments-namespace
spec:
  container:
    replicas: 1
    resources:
      limits:
        cpu: 50m
        memory: 2Gi
      requests:
        cpu: 50m
        memory: 100Mi
    isPersistenceEnabled: true
    diskSize: 1Gi

You can create similar manifests for AWS VPC, GKE Cluster, Kafka on Kubernetes, and many more.

3. Deploy

project-planton pulumi up --manifest redis.yaml

---

Learn More

• Getting Started Guide - Your first deployment in 5 minutes
• Component Catalog - Browse 118+ deployment components across 10 providers
• Architecture - How Protocol Buffers, IaC modules, and CLI work together
• Planton Cloud - Commercial SaaS platform with UI, CI/CD, and team features

---

Contributing

Visit CONTRIBUTING.md for information on building ProjectPlanton from source or contributing improvements.

Also, refer to this Contributor Guide for detailed information about becoming a contributor to Project-Planton.

License

Project Planton is released under the Apache 2.0 license. You are free to use, modify, and distribute this software in accordance with the license terms.

Acknowledgments

• Brian Grant & Kubernetes API team for their foundational work on the Kubernetes Resource Model.
• The Protobuf Team for laying the foundation for a powerful language neutral contract definition language.
• The Buf Team for their Protobuf tooling—including BSR Docs, BSR SDKs, and ProtoValidate — which collectively democratized protobuf adoption and made this project possible.
• The Pulumi team for providing a powerful infrastructure as code platform that enables multi-language support.
• The spf13/cobra team for making building command line tools a bliss.