Getting Started with YAAA.app

The AI Agent Execution Manual — set up and run your first autonomous workflow in under five minutes.

What is YAAA.app?

YAAA.app is an open-source platform for building, orchestrating, and monitoring autonomous AI agent workflows. It provides a modular C++ core with multi-language scripting (Python, Lua, C#), a modern GUI, and built-in verification pipelines so you can go from idea to production-grade agent with minimal friction.

v0.9.4.5 C++ Core Python · Lua · C# Cross-platform

Prerequisites

  • C++ compiler — GCC 11+ or Clang 14+
  • CMake — version 3.20 or newer
  • Python — 3.13+
  • Lua — 5.4+
  • .NET SDK — 8.0+ (required for C# scripting support)

Installation

  1. Clone the repository 
    git clone https://github.com/your-org/yaaa-app.git
cd yaaa-app
git submodule update --init --recursive
  2. Configure the build 
    mkdir build && cd build
cmake -S .. -B . \
  -DCMAKE_BUILD_TYPE=Debug \
  -DENABLE_TESTS=ON \
  -DENABLE_DOCS=ON \
  -DCOMPONENT=ALL
  3. Compile 
    cmake --build . -j$(nproc)
  4. Run the test suite 
    ctest --output-on-failure
  5. Launch YAAA.app 
    ./src/yaaa_app/YAAA.APP

Your First Agent Workflow

After launching, create a new project and add a simple Python script agent:

# agents/hello_world.py
from yaaa import Agent, Tool

@Tool
def greet(name: str) -> str:
    return f"Hello, {name}! YAAA.app is running."

agent = Agent(
    name="hello-agent",
    tools=[greet],
    model="spark",
)

if __name__ == "__main__":
    result = agent.run("Greet the user")
    print(result)

Run it from the YAAA.app script editor or from the command line:

python agents/hello_world.py

Next Steps

  • Full documentation — deep dive into architecture, APIs, and configuration.
  • Download — get the latest pre-built binaries for your platform.
  • Support — community Discord, GitHub Issues, and enterprise support options.