# Aegis Foundation

Reliable infrastructure tooling for your servers.

<p align="left">
  <img src="./img/logo.png" alt="Aegis Foundation logo" width="200" />
</p>

---

## Projects

### Konduktor

> Golang re-imagining of the original PyServe idea.

- High-performance web server and reverse proxy.
- Declarative configuration via YAML/JSON.
- Multiple services, routes, and hosts in a single config.
- Suitable for both side projects and small/medium production setups.

👉 Repository: `konduktor`      
👉 Documentation: _to be added_

---

### PyServe (legacy)

Original Python implementation.

- Built on top of Starlette / Uvicorn.
- Used as a reference implementation and playground for fast experiments.
- Many concepts were later refined and moved into Konduktor.

👉 Repository: [`pyserve`](https://git.pyserve.org/aegis/pyserveX)  
👉 Documentation: [`LINK`](https://docs.pyserve.org/)

---

## For Contributors

Contributions are welcome — but we value clarity and predictability.

### Workflow

1. Find or open an issue with a clear problem statement.
2. Fork the repository.
3. Create a branch: `feature/...` or `fix/...`.
4. Open a pull request with a concise description of the change.

### Principles

- Prefer **simple and explicit** solutions over clever “magic”.
- Keep configuration and behavior **transparent**.
- When public behavior changes, **update tests and documentation**.

---

## Stack & Philosophy

- **Languages:** Go, Python (legacy parts), some TypeScript/JS for docs and tooling, LUA (We hope...).
- **Philosophy:**
  - configuration over hidden logic;
  - explicit contracts between services;

---

## License

By default, Aegis Foundation projects use the **MIT License**, unless stated otherwise.  
Check the `LICENSE` file in each repository for details.

---

## Contact

- Gitea: `https://git.pyserve.org/`
- For questions and proposals: [`lead@pyserve.org`](mailto:lead@pyserve.org).

---

> Aegis Foundation — the part of your infrastructure that just quietly does its job.