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.
- 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 | 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 |
| 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 |
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 installAdd 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
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 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
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.zipGuides: initializer.pyahu.io. Generator: start.pyahu.io. Repository: github.com/pyahu/initializer
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.
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.
- ⭐ 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.