Skip to content

Pyahu

Pyahu

Great software. Built on better foundations.
A development suite that brings good practices, automation and AI into your team's everyday work.
From the first project to production.

Website · Português · Guides · Starter · Contact


Welcome to Pyahu Community: open foundations and tools you can adopt at your own pace.

Good engineering takes more than a framework. Pyahu brings together the foundations of software delivery, so your team spends more time on the product and less time rebuilding its development stack. Distinct tools, one shared direction: start where your team needs help, and adopt the other pieces as your workflow grows.

What we believe

  • Good practices, built in. Architecture, testing and observability are part of the work from the start.
  • Automation with intent. Repeat the checks and routines, and keep people in charge of the decisions.
  • A foundation you own. Open tools, versioned configuration and infrastructure you can understand.

From idea to production

# Step Tool Goal
1 Prepare Toolchain Get the team on the same page
2 Create Initializer Start with the right foundations
3 Develop Line From a refined ticket to a reviewed pull request
4 Validate CLI Make local development real
5 Operate Open Cluster Foundation and Cloud Build infrastructure you understand

Community projects

Project What it does Status
Toolchain Curated developer tools managed by mise; stable profiles pin exact versions on every workstation ✅ Available
CLI Local Kubernetes (k3d) with the services your app needs, in one command ✅ Available
Initializer Production guides for Spring Boot services and a generator that starts a project already following them 🧪 Public preview
Open Cluster Foundation Kubernetes foundations for OCI, with Terraform and an observable service layer ✅ OCI available
Line Carries a refined story to a reviewed pull request, with code deciding what is ready and when to stop 🛠️ Coming soon

Pyahu Toolchain

Get the team on the same page. A curated, composable set of CLI tools, organized by category and managed with mise. No dev container and no per-language version managers. You get a small cross-stack baseline plus the workflow profiles you choose: workstation, java, go, python, node, cloud, ai and arch. Stable profiles pin exact versions; the ai profile follows recent releases.

Requires mise:

git clone https://github.com/pyahu/toolchain.git ~/.config/pyahu-toolchain
cd ~/.config/pyahu-toolchain
./install.sh workstation java cloud   # pick the profiles you use; it links the config
export MISE_ENV=workstation,java,cloud
mise install

Add mise activation and the same MISE_ENV value to your shell startup file to keep the setup.

Docs: toolchain.pyahu.io. Repository: github.com/pyahu/toolchain

Pyahu CLI

Make local development real. Bring up a local Kubernetes cluster and the services your application needs, then develop and validate against a reproducible stack on your machine. PostgreSQL, ZITADEL (OIDC over local HTTPS), RabbitMQ, Valkey, Kafka, Kafka Connect with Debezium and Kafka UI, all declared in a single pyahu.yaml.

curl -fsSL https://cli.pyahu.io/install.sh | sh
pyahu init --preset platform   # generate the stack
pyahu up                       # bring up the cluster
eval "$(pyahu env)"            # connect your apps

Docs: cli.pyahu.io. Repository: github.com/pyahu/cli

Open Cluster Foundation

Build infrastructure you understand. Production-oriented Kubernetes foundations: a Terraform foundation per provider and a provider-agnostic Helmfile base for ingress, TLS, GitOps and observability, with optional database, messaging, cache, identity and secrets operators. Every version is pinned and validated in CI. OCI (OKE) today, with more providers on the roadmap.

Docs: ocf.pyahu.io. Repository: github.com/pyahu/open-cluster-foundation

Pyahu Initializer

Start with the right foundations. 24 guides that explain each production decision for a Spring Boot service, from the first build to Kubernetes, and a generator that starts a project already following them:

  • Service: Spring Boot 4 on Java 25, REST contract first
  • Architecture: hexagonal or DDD layered, checked by tests
  • Options: PostgreSQL with migrations, OIDC and a Next.js frontend
  • Production: OpenTelemetry, a hardened container image, GitHub Actions and Kubernetes manifests

Every supported combination is generated, built and started by CI before it ships.

curl https://start.pyahu.io/starter.zip -d name=orders -d database=postgres -o orders.zip

Guides: initializer.pyahu.io. Generator: start.pyahu.io. Repository: github.com/pyahu/initializer

Pyahu Line (coming soon)

Important

In development. Line is not available yet. It works with Linear today and will be open sourced as a Community project.

AI writes the code. Your process decides what ships. Line takes a story your team has refined and carries it to a reviewed pull request, with nobody in the middle. The model writes and reviews; everything else is code that reads files: whether the story is ready, whether the change works and when to stop.

Ready story → Story rules → Implementation → Checks → Review → Pull request → A person decides
  • Story rules: code checks title, estimate and acceptance criteria; a story that fails goes back to its author.
  • Implementation: one model session, test first.
  • Checks: the project's own build and test commands, run by Line.
  • Review: a second model, read only.
  • Your standard: a rules file based on Extreme Programming, which each project can adjust rule by rule.
  • Limits: time, cost and repairs are capped for every story, and files such as CI and agent instructions are never touched.

Pyahu Cloud (Enterprise)

Community and Enterprise are complementary ways to adopt Pyahu: choose what you run yourself, and where you want our team alongside yours.

Pyahu Cloud runs your code in production with managed delivery and operations, isolated environments, PostgreSQL and observability: in Pyahu's cluster, or in your own cluster through the Pyahu Kubernetes Operator. It is JVM-first and comes with guided adoption, an adoption path built around your team and a direct relationship with the people building Pyahu.

Talk to the team

Get involved

  • ⭐ Star and watch the projects above to follow their progress.
  • 🐛 Found a bug or have an idea? Open an issue in the project's repository.
  • 🤝 Pull requests are welcome. Source code and configuration are in your hands.
  • ✉️ hello@pyahu.io

Pyahu. Better foundations. Better software.

Popular repositories Loading

  1. toolchain toolchain Public

    Pyahu Community certified developer toolchain, managed by mise

    Python 2

  2. cli cli Public

    Local dev infrastructure in one command: Postgres, ZITADEL, RabbitMQ, Kafka and more on k3d.

    Go 2

  3. open-cluster-foundation open-cluster-foundation Public

    Readable Terraform and Helmfile building blocks for creating and operating Kubernetes on OCI OKE.

    Shell 2

  4. .github .github Public

  5. initializer initializer Public

    Production guides for Spring Boot services, proven by tested fixtures

    MDX

Repositories

Showing 5 of 5 repositories

Top languages

Loading…

Most used topics

Loading…