HAPE Framework
A Python CLI and FastAPI toolkit for platform and DevOps automation.
Same commands, safety levels, and approval rules for engineers and AI coding agents.
How it compares
HAPE complements CI and IaC.
It does not replace Terraform or Kubernetes.
✅ Yes ❌ No ◐ Partial
| Approach | Named repeatable CLI | Safety level before run | Approval for write or delete | Shared human and AI rules | Secret redaction |
|---|---|---|---|---|---|
| Ad-hoc scripts plus kubectl | ❌ | ❌ | ❌ | ❌ | ◐ |
| GitHub Actions or GitLab CI | ◐ | ❌ | ◐ | ❌ | ◐ |
| Terraform | ✅ | ◐ | ◐ | ❌ | ◐ |
| Unrestricted AI agent in an IDE | ❌ | ❌ | ❌ | ❌ | ❌ |
| HAPE Framework | ✅ | ✅ | ✅ | ✅ | ✅ |
Read the Comparison notes.
Benefits for engineers
- Repeatable commands: keep automation in auditable CLI and API paths instead of one-off scripts.
- Readable safety: see read, write, or delete before a command runs.
- Shared rules: humans and AI coding agents follow the same approval workflow.
- Redacted secrets: sensitive values stay hidden unless you pass
--reveal-secrets.
First useful output
Two read commands produce reports you can inspect.
AI-assisted automation
Agents can propose a hape command.
You still see the safety level, the side effects, and whether approval is required.
- Same surface: CLI and HTTP API stay aligned for most commands.
- Agent rules: repository LLM rules classify tools, redact secrets, and stop for approval.
- Explicit gates: write, delete, remote, publish, apply, and rollout need a yes.
Add those rules from the AI IDE integration guide.
What it automates
- Repositories: inspect or bootstrap GitHub and GitLab projects.
- DORA metrics: compute delivery metrics and run exporters.
- Kubernetes: investigate incidents with explicit read commands.
- EKS cost: report Deployment and StatefulSet cost.
How it works
CLI and API call the same services, then clients, then the external systems.
flowchart LR
cli[CLI]
api[HTTP API]
services[Services]
clients[Clients]
systems[External systems]
cli --> services
api --> services
services --> clients
clients --> systems
Read the CLI, API, service, and client model for layer ownership.
Safety and trust
Classify a command before you run it.
- Read: fetch, list, describe, or show only.
- Write: create or update.
- Delete: destructive actions such as delete, purge, rotate, apply, or rollout.
Start with Command safety.
Get started
Install the CLI, then run a read command.
- Install HAPE
- Five-minute quick start
- First useful output
- Configure one integration
- Understand command safety
- Add HAPE rules to your AI IDE
python -m pip install hape
hape --version
hape --help
hape config show
hape config show is a read command with no side effects.
Demos
Runnable examples live with the source and in the documentation portal.
Open source
HAPE Framework is licensed under the MIT License.
License
MIT License.
Copyright (c) 2026 Hazem Ataya.
See LICENSE.
Contributions
Public pull requests are accepted.
Every pull request requires personal review and explicit approval from Hazem Ataya.
See CONTRIBUTING.md.
Security
Report vulnerabilities privately to hazem.ataya@hapesolutions.com.
See SECURITY.md.
HAPE Solutions
- HAPE Solutions is the company website.
- HAPE Vibes is a separate product for service creation and deployment workflows.
Docker
A container image is published on Docker Hub as hazemataya/hape.
Author
1 maintainer
Metadata
1 maintainer
Release files for hape 1.2.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hape-1.2.12.tar.gz | 149.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hape-1.2.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 368.9 kB
Release files / hape-1.2.12.tar.gz
| Download URL | hape-1.2.12.tar.gz |
|---|---|
| Size | 149.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a8f5299f71a8d7ae8e26afeb0028bb89ecc3e5ebe1be0ac303d0fa78e7616671
|
|
BLAKE2b-256 checksum How to use checksums |
d9ea9a83184eece22f5112badd117a323f53758f048e5752ab06f6421334b4aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / hape-1.2.12-py3-none-any.whl
| Download URL | hape-1.2.12-py3-none-any.whl |
|---|---|
| Size | 219.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1a2dfedf2d6624f8db639e2ef7c083f1b6e4cb2361d20f7cbeea32d29afc113b
|
|
BLAKE2b-256 checksum How to use checksums |
6b74593cb869e70d79e13f018b12338ab59dbd6162720980590b11936b191f04
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
