Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Pragmatica Aether

Distributed runtime for Java -- scale horizontally without microservices complexity.

Overview

Aether lets you deploy Java services as slices and handles distribution, scaling, and resilience automatically. A slice is a typed Java interface with dependency injection via factory method parameters -- the same service model as Spring @Service, without the infrastructure overhead. Write services, and Aether manages deployment across nodes, automatic scaling based on CPU/latency/request rate, failure recovery, and load balancing. No actors, no message passing, no new paradigm to learn.

@Slice
public interface PlaceOrder {
    Promise<OrderResult> execute(PlaceOrderRequest request);

    static PlaceOrder placeOrder(InventoryService inventory, PricingService pricing) {
        return request ->
            inventory.checkStock(request.items())
                .flatMap(stock -> pricing.calculateTotal(request.items()))
                .flatMap(total -> createOrder(request, stock, total));
    }
}

Usage

Quick Start

# Check cluster status
aether status

# Deploy a slice
aether deploy org.example:my-slice:1.0.0

# Scale it
aether scale org.example:my-slice:1.0.0 -n 3

Local Development with Forge

aether-forge
# Open http://localhost:8888

Forge provides a visual dashboard, cluster operations, chaos testing, and per-node management API access.

Installation

Requires Java 25.

curl -fsSL https://raw.githubusercontent.com/siy/aether/main/install.sh | sh

Build from Source

git clone https://github.com/siy/aether.git
cd aether && mvn package -DskipTests

Documentation

Category Documents
Start Here What is Aether?, Introduction, Getting Started, Migration Guide, FAQ
Core Concepts Scaling, Slice Lifecycle, Architecture
Reference CLI Reference, Forge Guide, Configuration, Management API
Operations Rolling Updates, Monitoring, Docker
Design Vision & Goals, Metrics & Control, Slice API

Project Structure

aether/
├── slice-api/           # Slice interface
├── slice/               # Slice management
├── node/                # Runtime (AetherNode)
├── cluster/             # Rabia consensus
├── forge/               # Local cluster simulator & dashboard
├── cli/                 # Command-line tools
└── examples/
    └── ecommerce/       # E-commerce demo

Dependencies

  • Java 25
  • Maven 3.9+
  • pragmatica-lite-core
  • pragmatica-lite-consensus