ORCH DSL: Usage and Project Structure

The ORCH DSL provides a distributed compilation pipeline. The front-end compiler, main.exe (written in OCaml), parses your ORCH project, generates a JSON representation (AST), and then invokes a Python script (converter.py) to transpile the project into a runnable Python application leveraging orch-lib.

Usage

You can run the compiler using the following syntax:

./main.exe [--dryrun] [--verbose] [--no-delete] <project_directory>

Options

• <project_directory> : (Required) Specifies the path to the directory containing your project.
• -dryrun : (Optional) Generates the Python file without executing it.
• -verbose : (Optional) Enables verbose logging.
• -no-delete : (Optional) Prevents automatic cleanup of the generated .json and .py files.

Internal Workflow

1. Parsing: main.exe reads the project in <project_directory>.
2. JSON Generation: Constructs an AST and outputs it as JSON.
3. Transpilation: Converts the JSON file to a Python execution file (<project_name>.py).
4. Execution: Automatically runs the Python file.
5. Cleanup: Deletes intermediate generated .json and .py files.

Project Structure

Your project should exist within a single directory. The ORCH DSL is designed to cleanly separate global orchestration logic from agent-specific task logic.

Directory Components