ailoos 4.5.4

Unified SDK experience for AILOOS federated AI nodes

AILOOS SDK

AILOOS is a robust Python library for participating in decentralized federated learning networks. This SDK enables nodes to join training sessions, contribute processing power, and interact with the Ailoos ecosystem securely.

Features

• Federated Learning: Participate in distributed model training sessions using FedAvg and other advanced algorithms.
• Privacy First: Secure key management and encrypted P2P communication (ECDSA + ECDH).
• Decentralized Marketplace: Interact with the data marketplace to list or purchase datasets.
• Hardware Integration: Smart capabilities detection for optimal workload assignment.

Node Roles

AILOOS supports 7 specialized node roles:

1. Scout: Lightweight discovery and inference.
2. Forge: heavy-duty model training.
3. Validator: ZKP verification and auditing.
4. Aggregator: Secure model aggregation.
5. Oracle: Trusted external data provider.
6. Archival: Long-term storage history.
7. Relay: Cross-chain bridging.

See Full Node Roles Documentation for details.

Network Scales

AILOOS organizes nodes into 5 intelligence scales:

1. Sovereign (El Átomo): 1 Node.
2. Binary (Binario): 2 Nodes. (Small personal networks)
3. Phalanx (La Escuadra): 3-20 Nodes.
4. Foundry (La Fundición): 100-5k Nodes.
5. Nexus (El Coloso): 100k+ Nodes.

Installation

AILOOS features a modular installation system to ensure high performance even on lightweight nodes:

# 1. Base Terminal & P2P Networking (For Scouts, Relays, Validators)
pip install ailoos

# 2. Heavy Computational Node (For Forge, requires PyTorch & Deep Learning engines)
pip install "ailoos[forge]"

Note: If you intend to train or run local inference via the ailoos-terminal, you MUST install the [forge] extension.

Initialize a Node

import asyncio
from ailoos.sdk.node_sdk import NodeSDK

async def main():
    # Initialize the node
    node = NodeSDK(node_id="my-ai-node-01")
    
    # Connect and start participating
    await node.initialize()
    await node.start()
    
    # Keep running
    while True:
        await asyncio.sleep(1)

if __name__ == "__main__":
    asyncio.run(main())

Advanced Usage

For granular control over components:

from ailoos.sdk.advanced_client import create_ailoos_node

async def run_advanced():
    # Create node with specific capabilities
    node = await create_ailoos_node(
        node_id="advanced-node-01",
        enable_marketplace=True,
        enable_federated=True
    )
    
    # Search for datasets
    datasets = await node.search_datasets(query="satellite imagery")
    print(f"Found {len(datasets)} datasets")

    # Join a training session
    await node.join_training_session("session_v1_xyz")

Requirements

• Python 3.8+
• Network connectivity for P2P and Federation

License

Proprietary and Confidential. Copyright © 2026 Empoorio INC. All Rights Reserved. See LICENSE for full terms.