Documentation

recurse.yaml

Describe the application, runtime, inputs, prompt, model, and tools.

Manifest structure

The manifest uses recurse.run/v1alpha1 and kind Agent. Metadata names the application. Runtime selects Python and its lockfile. Agent selects the model and prompt. Inputs define accepted values, and tools register callable Python functions.

api_version: recurse.run/v1alpha1
kind: Agent

metadata:
  name: tiny-tuner
  title: Tiny Model Tuner
  summary: Tunes a tiny classifier.

runtime:
  python: "3.14"
  lockfile: uv.lock

agent:
  model: openai/gpt-5.6-luna
  prompt: prompts/system.md

inputs:
  type: object
  required: [target_f1]
  properties:
    target_f1:
      type: number
      minimum: 0.5
      maximum: 1.0

tools:
  source: toolkit.py
  register:
    train_model: ~
    validate_model: ~

Validation

The SDK checks the manifest, declared paths, and tool registrations before it creates a bundle. Authoring problems are reported together so you can correct the project before deploying.