Skip to content

ApiliumCode/aingle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

130 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

AIngle(TM)

The Semantic Infrastructure for Intelligent Applications

Enabling enterprises to build secure, scalable, and intelligent distributed systems

Build Status License Rust Powers Mayros AI

SolutionsCapabilitiesGet StartedWebsite


Why AIngle?

Modern enterprises face a critical challenge: legacy systems can't keep pace with the demands of IoT, real-time compliance, and intelligent automation. Traditional databases are too slow. Blockchains are too heavy. Point solutions create silos.

AIngle is different.

Built from the ground up as a Semantic DAG (Directed Acyclic Graph), AIngle combines the best of distributed ledgers, graph databases, and edge computing into a single, unified platform.

The Result?

Traditional Approach With AIngle
Weeks to detect compliance violations Real-time detection
Knowledge lost when employees leave Captured and searchable forever
IoT devices can't run complex logic Full intelligence at the edge
Separate systems for data, logic, privacy One unified platform

Enterprise Solutions

🔍 Deep Context — Preserve Institutional Knowledge

The Problem: When senior developers leave, they take critical knowledge with them. New team members see what the code does, but not why decisions were made. This creates technical debt and repeated mistakes.

The Solution: Deep Context captures architectural decisions, design rationale, and semantic relationships directly in your development workflow.

Business Impact:

  • 50% faster onboarding for new developers
  • Reduce technical debt from uninformed decisions
  • Audit-ready decision history
  • Searchable knowledge base that grows with your codebase
"Why did we choose microservices for the payment system?"
→ Deep Context returns the original decision, alternatives considered,
  and the business context from 2 years ago.

Explore Deep Context →


🏦 Semantic Compliance — Real-Time AML/KYC

The Problem: Financial institutions review customers annually. If an entity appears on a sanctions list today, it can take weeks to detect. Manual processes create compliance gaps and regulatory risk.

The Solution: AIngle's Semantic Compliance monitors sanctions lists in real-time, using graph analysis to detect hidden relationships and fuzzy matching to catch name variations.

Business Impact:

  • Instant detection when sanctions lists change
  • Uncover hidden networks through graph analysis
  • Reduce false positives with semantic matching
  • Immutable audit trail for regulatory proof
Traditional: Annual review → 365-day exposure window
AIngle:      Real-time sync → Minutes to detection

Explore Semantic Compliance →


📡 Edge Intelligence — IoT Without Compromise

The Problem: IoT devices have limited resources but need to make intelligent decisions. Cloud round-trips add latency. Connectivity isn't guaranteed. Yet you need security, coordination, and smart behavior.

The Solution: AIngle Minimal runs on devices with less than 1MB RAM, providing full DAG capabilities, peer-to-peer gossip, and embedded intelligence at the edge.

Business Impact:

  • Sub-second decisions without cloud dependency
  • Automatic anomaly detection on-device
  • Mesh networking between devices
  • Zero infrastructure costs for device-to-device communication

Supported Protocols: CoAP • mDNS • Gossip • DTLS

Explore IoT Capabilities →


Key Capabilities

🧠 Semantic Graph Engine

Native graph database with SPARQL queries. Model complex relationships, run pattern matching, and traverse connections—all without external dependencies.

🔐 Zero-Knowledge Privacy

Prove facts without revealing data. Schnorr signatures, Pedersen commitments, and Bulletproofs built-in. Perfect for identity verification and confidential transactions.

⚡ Kaneru

Unified Multi-Agent Execution System. Reinforcement learning (Q-Learning, SARSA, TD) for autonomous decision-making. From anomaly detection to resource optimization.

🌐 Unified API Layer

One interface, three protocols. REST for simplicity, GraphQL for flexibility, SPARQL for semantic queries. The Cortex API adapts to your needs.

📜 Smart Contracts

Rust-based DSL compiled to WASM. Type-safe, sandboxed execution with deterministic results. Deploy business logic that runs anywhere.

📊 Real-Time Visualization

Interactive D3.js dashboard. Watch your DAG evolve in real-time. Filter, search, export, and analyze system behavior visually.


Clustering

AIngle supports multi-node clustering via Raft consensus for high availability and horizontal scalability. Writes are replicated to all nodes; reads can be served from any node with optional quorum consistency.

Quick Start (3-node cluster)

# Node 1 — bootstrap leader
aingle-cortex --port 8081 \
  --cluster --cluster-node-id 1 \
  --cluster-secret "your-secret-at-least-16-chars" \
  --cluster-wal-dir ./data/node1/wal \
  --db-path ./data/node1/graph.sled

# Node 2 — joins via node 1
aingle-cortex --port 8082 \
  --cluster --cluster-node-id 2 \
  --cluster-peers 127.0.0.1:8081 \
  --cluster-secret "your-secret-at-least-16-chars" \
  --cluster-wal-dir ./data/node2/wal \
  --db-path ./data/node2/graph.sled

# Node 3 — joins via node 1
aingle-cortex --port 8083 \
  --cluster --cluster-node-id 3 \
  --cluster-peers 127.0.0.1:8081 \
  --cluster-secret "your-secret-at-least-16-chars" \
  --cluster-wal-dir ./data/node3/wal \
  --db-path ./data/node3/graph.sled

With TLS encryption

# Auto-generated self-signed certs (development)
aingle-cortex --port 8081 --cluster --cluster-node-id 1 \
  --cluster-secret "your-secret" --cluster-tls

# Custom certificates (production)
aingle-cortex --port 8081 --cluster --cluster-node-id 1 \
  --cluster-secret "your-secret" --cluster-tls \
  --cluster-tls-cert /path/to/cert.pem \
  --cluster-tls-key /path/to/key.pem

Cluster endpoints

Endpoint Method Description
/api/v1/cluster/status GET Node role, leader ID, current term
/api/v1/cluster/members GET All cluster members and their state
/api/v1/cluster/join POST Add a new node to the cluster
/api/v1/cluster/leave POST Gracefully remove a node
/api/v1/cluster/wal/stats GET WAL segment count and disk usage
/api/v1/cluster/wal/verify POST Verify WAL integrity (checksums)

Features

  • Raft consensus — automatic leader election, log replication, and membership changes
  • Streaming snapshots — 512KB chunked transfer with per-chunk ACK for large datasets
  • Write-Ahead Log — crash-safe durability with segment rotation and integrity verification
  • TLS encryption — optional TLS for inter-node communication (self-signed or custom certs)
  • Constant-time auth — cluster secret verified with timing-safe comparison
  • Quorum reads — optional strong consistency for read operations

Architecture

┌────────────────────────────────────────────────────────────────────────┐
│                         APPLICATION LAYER                               │
│   ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌───────────┐ │
│   │    Zomes     │  │   Contracts  │  │   Kaneru     │  │  DAG Viz  │ │
│   │   (WASM)     │  │  (Rust DSL)  │  │    (RL)      │  │  (D3.js)  │ │
│   └──────────────┘  └──────────────┘  └──────────────┘  └───────────┘ │
├────────────────────────────────────────────────────────────────────────┤
│                            API LAYER                                    │
│   ┌────────────────────────────────────────────────────────────────┐  │
│   │              Cortex API (REST • GraphQL • SPARQL)               │  │
│   └────────────────────────────────────────────────────────────────┘  │
├────────────────────────────────────────────────────────────────────────┤
│                          CORE SERVICES                                  │
│   ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌───────────┐ │
│   │  Semantic    │  │    Logic     │  │  ZK Proofs   │  │ Contracts │ │
│   │   Graph      │  │   Engine     │  │  (Privacy)   │  │  Runtime  │ │
│   └──────────────┘  └──────────────┘  └──────────────┘  └───────────┘ │
├────────────────────────────────────────────────────────────────────────┤
│                        CONSENSUS LAYER                                  │
│   ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌───────────┐ │
│   │    Raft      │  │     WAL      │  │  Streaming   │  │   TLS     │ │
│   │ (openraft)   │  │ (Durability) │  │  Snapshots   │  │  (mTLS)   │ │
│   └──────────────┘  └──────────────┘  └──────────────┘  └───────────┘ │
├────────────────────────────────────────────────────────────────────────┤
│                         NETWORK LAYER                                   │
│   ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌───────────┐ │
│   │ Kitsune P2P  │  │    CoAP      │  │   Gossip     │  │   mDNS    │ │
│   │   (QUIC)     │  │   (IoT)      │  │ (Optimized)  │  │ Discovery │ │
│   └──────────────┘  └──────────────┘  └──────────────┘  └───────────┘ │
└────────────────────────────────────────────────────────────────────────┘

Getting Started

Quick Start

# Clone
git clone https://github.com/ApiliumCode/aingle.git
cd aingle

# Build
cargo build --workspace --release

# Build with clustering support
cargo build -p aingle_cortex --features cluster --release

# Test
cargo test --workspace

# Documentation
cargo doc --workspace --no-deps --open

Prerequisites

  • Rust 1.83 or later
  • libsodium-dev (cryptography)
  • libssl-dev (TLS)
  • pkg-config

Run Examples

# Deep Context - Semantic Git
cd examples/deep_context
cargo run --release -- --help

# Semantic Compliance - AML/KYC
cd examples/semantic_compliance
cargo run --release -- --help

Documentation

Guide Description
Getting Started Build your first AIngle application
IoT Networks Deploy sensors with edge intelligence
Kaneru Add autonomous decision-making
Semantic Queries Master GraphQL and SPARQL
Privacy (ZK) Implement zero-knowledge proofs
Visualization Monitor your system in real-time

Full API Reference:

cargo doc --workspace --no-deps --open

Platform Components

Core

Component Purpose
aingle Main conductor and runtime
aingle_minimal Ultra-light IoT node (<1MB)
kitsune_p2p P2P networking (QUIC)
aingle_sqlite Persistent storage

Intelligence

Component Purpose
kaneru Kaneru multi-agent execution framework
aingle_logic Prolog-style reasoning engine
aingle_graph Semantic graph database

Clustering & Consensus

Component Purpose
aingle_raft Raft consensus (leader election, log replication, streaming snapshots)
aingle_wal Write-Ahead Log for crash-safe durability

Security & Privacy

Component Purpose
aingle_zk Zero-knowledge proofs
aingle_contracts Smart contract runtime
aingle_cortex API gateway with auth

SDKs

Official SDKs for integrating AIngle into your applications:

Language Package Repository
JavaScript/TypeScript @apilium/aingle-sdk aingle-sdk-js
Python aingle-sdk aingle-sdk-python
Go github.com/ApiliumCode/aingle-sdk-go aingle-sdk-go
Swift AIngleSDK aingle-sdk-swift
Kotlin com.apilium:aingle-sdk aingle-sdk-kotlin

Quick Example (JavaScript)

import { AIngleClient } from '@apilium/aingle-sdk';

const client = new AIngleClient('http://localhost:19090');

// Create an entry
const hash = await client.createEntry({ sensor: 'temp', value: 23.5 });

// Subscribe to real-time updates
client.subscribe((entry) => {
  console.log('New entry:', entry.hash);
});

Running with SDK Support

# Start node with REST API enabled
aingle-minimal run --rest-port 19080

Contributing

We welcome contributions from the community.

  1. Fork the repository
  2. Create your feature branch
  3. Write tests for new functionality
  4. Ensure all tests pass: cargo test --workspace
  5. Format code: cargo fmt --all
  6. Submit a pull request

See our contribution guidelines for details.


License

Dual License: Apache-2.0 + Commercial

Copyright © 2019-2026 Apilium Technologies OÜ

AIngle is available under two licenses:

  • Apache License 2.0 — Free for personal use, education, research, evaluation, and organizations with annual revenue below USD $1M. See LICENSE-APACHE.

  • Commercial License — Required for commercial integration, SaaS offerings, and organizations with annual revenue above USD $1M. See LICENSE-COMMERCIAL.

For commercial licensing: [email protected]


Ready to transform your enterprise?

Visit apilium.com  •  Contact Us  •  GitHub

Apilium Technologies OÜ • Tallinn, Estonia


Trademarks: AIngle, AIngle Cortex, Ineru, and Kaneru are trademarks of Apilium Technologies OÜ. See NOTICE for details.

License: Dual licensed under Apache-2.0 and Commercial. See PATENTS for protected technologies.

Packages

 
 
 

Contributors