Skip to main content

Examples

Working YAMLs, each written against the real compiler and module behavior. The full collection (with deeper context) lives in language/15-examples.md; this section is the curated subset that backs the doc's recipes.

Smallest possible app​

The minimum that compiles and runs:

app.yaml
app:
  app_id: smallest
  name: Smallest

agents:
  - id: a
    role: assistant
    brain:
      provider: ollama
      model: qwen25-7b-gpu:latest
      backend: openai_compat
      config:
        base_url: http://localhost:11434/v1
        api_key: ollama
    system_prompt: "Reply with exactly one word: pong."

Deploy + chat (against a daemon on the default http://127.0.0.1:8000 - set DIGITORN_URL to point elsewhere):

bash
digitorn install smallest.yaml
digitorn chat smallest

Canonical 8-block reference​

The example documented in Language - Minimal example exercises every top-level block. Use it as a template when authoring a new YAML.

Real-world examples​

For production-shape apps (multi-agent, RAG, channels, sandboxed MCP, credentialed brains), see language/15-examples.md. Each example there names the modules it requires, the credentials it expects, and the deploy command.

Verifying an example yourself​

The most reliable check for any YAML in these docs:

  1. Save it to a file.
  2. digitorn install <file> - the daemon compiles it server-side; a failure here means the YAML is structurally wrong.
  3. digitorn chat <app-id> and send the prompt shown in the example - the TUI streams the reply the same way a real session would.