commit 7a51e3e6ffefe7a77ba44836558f668d6dccb87b Author: Ilya Glazunov Date: Thu Dec 11 22:33:36 2025 +0000 Добавить README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..48da5a2 --- /dev/null +++ b/README.md @@ -0,0 +1,78 @@ +# Aegis Foundation + +Reliable infrastructure tooling for your servers. + +--- + +## 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. \ No newline at end of file