DocsIntroduction

Introduction

Awee is an automation engine for macOS, Windows, and Linux. Turn everyday operations into workflows you write once, chain AI models and API calls inside, and run anywhere.

A workflow is a list of steps you write once and run anywhere. Each step runs one component, an AI model call, an HTTP request, a file or data operation, and passes its result to the steps that follow. Wire the steps together and the engine runs them in order.

Automate everyday operations that run through APIs, files, and online services, with a model in the loop wherever something needs to be read, judged, or written. Because every step is static configuration, we can see exactly what ran, what each model was asked, the answer and what it cost, so there is a clear account of every decision an automation made on your behalf. Steps also nest, so a loop, a branch, or a whole other workflow is itself just one step, which keeps a large automation modular instead of sprawling.

The same definition reads clearly to people and to language models, and it runs unchanged from the command-line app, the REST API, or the web app. Under the hood the engine compiles each workflow into a static, inspectable plan, then executes it with conditions, loops, retries, and caching, so an automation stays predictable even with a model in the loop.

Engine Lifecycle
  1. Definition

    An ordered list of steps in YAML or JSON, readable by people and models alike.

  2. Planner

    The plan is compiled static and inspectable, with immutable, hierarchical step IDs.

  3. Executor

    Each step runs its component with conditions, loops, retries, and caching.

  4. Outputs

    Every result feeds the steps that come after it, then the run returns its outputs.

Steps pass data forward with {{ step.field }} expressions from sintax, the template language, so a later step reads any earlier step's output.

Every run is metered and logged. Cost is tracked per step and reported across currencies, so an automation stays auditable even with a model in the loop.

Universal

The same workflow runs unchanged wherever you launch it. Windows, macOS and Linux.

CLI

Run a workflow from the command-line app on macOS, Windows, or Linux.

REST API

Trigger runs and read outputs over HTTP, with a JSON Schema for the result.

Web app

Launch the same workflow from a form the platform renders from its inputs.