README.md

May 26, 2026 ยท View on GitHub

Aastro API Gateway

A lightweight, modular, and high-performance API Gateway for modern microservices.

Built with simplicity, performance, and developer-friendly configuration in mind.

Go Version License Go Report Card codecov Docker Pulls GitHub Created At GitHub release


โœจ Features

  • ๐Ÿš€ High-performance HTTP reverse proxy
  • ๐Ÿ”€ Request fan-out & response aggregation (merge, array, namespace)
  • ๐Ÿงฉ Dynamic .so plugin system (request & response phase)
  • ๐Ÿ”— Path parameter extraction and forwarding
  • ๐Ÿ” Retry, circuit breaker & load balancing (round-robin, least-conns)
  • ๐Ÿ“Š Prometheus metrics with circuit breaker state tracking
  • ๐Ÿ›ก Rate limiting & trusted proxy support
  • ๐Ÿ“ฆ YAML-based configuration
  • ๐Ÿณ Docker-ready

๐Ÿš€ Quick Start

git clone https://github.com/starwalkn/aastro.git
cd aastro

make all GOOS=<YOUR_OS> GOARCH=<YOUR_ARCH>
./bin/aastro -c path/to/config.yaml

Or with Docker:

docker run \
  -p 7805:7805 \
  -v $(pwd)/config.yaml:/etc/aastro/config.yaml \
  -e AASTRO_CONFIG=/etc/aastro/config.yaml \
  starwalkn/aastro:latest

๐Ÿ“– Documentation

Full documentation, configuration reference, and plugin guide are available at:

starwalkn.github.io/aastrodocs


๐Ÿ“„ License

Open-source. See LICENSE file for details.


Made with โค๏ธ in Go