81 lines
2.0 KiB
Markdown
81 lines
2.0 KiB
Markdown
# Aegis Foundation
|
|
|
|
Reliable infrastructure tooling for your servers.
|
|
|
|
<p align="left">
|
|
<img src="./img/logo.png" alt="Aegis Foundation logo" width="165" />
|
|
</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. |