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 · CLI docs · 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.
- 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.
| # | Step | Tool | Goal |
|---|---|---|---|
| 1 | Prepare | Toolchain | Get the team on the same page |
| 2 | Create | Initializer | Start with the right foundations |
| 3 | Develop | AI Factory | Build with AI and keep the discipline |
| 4 | Validate | CLI | Make local development real |
| 5 | Operate | Open Cluster Foundation and Cloud | Build infrastructure you understand |
| Project | What it does | Status |
|---|---|---|
| Toolchain | Curated developer tools managed by mise, with consistent versions on every workstation | ✅ Available |
| CLI | Local Kubernetes (k3d) with the services your app needs, in one command | ✅ Available |
| Open Cluster Foundation | Production-grade Kubernetes from zero: Terraform plus an observable service layer | ✅ OCI available |
| Initializer | Projects generated with your architecture and delivery practices already in place | 🛠️ Coming soon |
| AI Factory | An AI coding harness with an Extreme Programming workflow | 🛠️ Coming soon (not production-ready yet) |
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.
git clone https://github.com/pyahu/toolchain.git ~/.config/pyahu-toolchain
cd ~/.config/pyahu-toolchain
./install.sh workstation java cloud # pick the profiles you useRepository: github.com/pyahu/toolchain
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 appsDocs: cli.pyahu.io. Repository: github.com/pyahu/cli
Build infrastructure you understand. Production-oriented Kubernetes foundations: a Terraform foundation per provider plus a provider-agnostic Helmfile base with Envoy Gateway, cert-manager, CloudNativePG, Kafka, observability (Prometheus, Loki, Tempo, Grafana) and Argo CD. Every version is pinned and validated in CI. OCI/OKE today, with more providers on the roadmap.
Repository: github.com/pyahu/open-cluster-foundation
Your next project, your team's standards. Choose how to build, not just which dependencies to install. Initializer turns architecture and organizational practices into a consistent starting point:
- Projects: Spring Boot, Quarkus and Next.js
- Structure: monorepo or multi-repo; single frontend or microfrontends
- Architecture and delivery: layered or hexagonal; GitHub Actions or GitLab CI
- Observability by design: OpenTelemetry, Grafana, Prometheus, Loki, Tempo and GlitchTip
Important
Not production-ready yet. AI Factory is in pre-release: the local workflow runs, but commands and contracts may still change, and capabilities such as dispatch mode are still planned. Launch is coming soon at ai.pyahu.io.
AI moves fast. Give it an engineering process. A harness powered by Pi as the model runtime, with an Extreme Programming workflow, curated skills and specialized agents. Turn a story into an explicit agreement, work through the test cycle and review the result, while your team sets the boundaries. Works with hosted, local or in-house models.
Story → Refinement → Test first (red, green, refactor) → Implementation → Review
Community and Enterprise are complementary ways to adopt Pyahu: choose what you run yourself, and where you want our team alongside yours.
Pyahu Cloud gives your code a place to run, with managed delivery and operations, isolated environments, PostgreSQL and observability. 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.
- ⭐ 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.
