FastAIRuntime 0.1.0 — Deterministic Execution Engine for Java

---

💡 Low-latency command execution and tool registries — Built for reliable local-first agent control in the FastJava AI ecosystem.

FastAIRuntime is a deterministic execution shell that manages system automation tools. By wrapping processes, hotkeys, and files behind strictly structured, observable execution boundaries (tools/commands), it enables cognitive agents to interact safely with the host operating system.

---

Technical Features

• 🛡️ Secure Execution Boundaries — Tools run via explicit command envelopes (FastCommand), yielding structured feedback (FastObservation).
• 🔧 Unified Tool Registry — Modular architecture to register local system utilities (UIA, Process tools, Keyboards).
• ⚡ Zero Bloat — Pure Java 17+ core with no external dependencies.
• 🚀 Native Integrations — Deeply integrated with FastJava's native subsystems (FastTerminal, FastUIA).

---

Quick Start

import fastairuntime.*;
import fastairuntime.tools.*;
import java.util.Map;

public class Demo {
    public static void main(String[] args) {
        FastAIRuntime runtime = new FastAIRuntime();
        
        // 1. Register deterministic OS tools
        runtime.register(new WindowsAppTool());
        runtime.register(new KeyboardTypeTool());

        // 2. Execute command
        FastObservation obs = runtime.execute(new FastCommand(
            "windows.open_app", 
            Map.of("path", "notepad.exe")
        ));
        
        System.out.println("Execution success: " + obs.success());
    }
}

---

Installation

Maven (JitPack)

Add JitPack repository and dependency to your pom.xml:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.andrestubbe</groupId>
        <artifactId>FastAIRuntime</artifactId>
        <version>0.1.0</version>
    </dependency>
</dependencies>

---

Related Projects

• FastAIAgent - Cognitive mind layer and planning loops
• FastAI - Unified AI client interface for Java
• FastAIMemory - Unified conversation memory
• FastAIVectorDB - JNI native vector database
• FastAIRag - Retrieval-augmented generation pipeline
• FastAIBot - High-performance bot orchestrator
• FastCore - Unified JNI loader and platform abstraction

---

License

This project is licensed under the MIT License.