digitorn 1.0.0

Declarative AI agent framework - build agent applications in YAML

Digitorn

Declarative AI agent framework. Build agent applications in YAML, run them locally or in the cloud, plug into any LLM (Anthropic, OpenAI, DeepSeek, Groq, Ollama, GitHub Copilot, ...) and any MCP server.

app:
  app_id: hello
  name: Hello

agents:
  - id: main
    role: assistant
    brain:
      provider: anthropic
      model: claude-sonnet-4-5
      backend: anthropic
      config:
        api_key: "claude-code"
    system_prompt: "Reply with one short sentence."

digitorn dev deploy hello.yaml
digitorn dev chat hello -m "ping"
# pong

The same YAML runs identically on a laptop, a server, a CI runner, or behind a reverse proxy. The daemon ships every primitive an agent needs: filesystem, shell, web, RAG, vector, database, LSP, MCP, channels (webhook / cron / email / slack / ...), hooks, behavior engine, sandbox, multi-agent orchestration, credentials vault, real-time event stream.

Install

Windows

Open PowerShell and run:

irm https://digitorn.ai/install.ps1 | iex

macOS / Linux

curl -fsSL https://digitorn.ai/install.sh | sh

The installer fetches Python 3.12 via uv, installs the digitorn CLI, registers a background service (Windows Service / launchd / systemd), and starts the daemon on http://127.0.0.1:8000.

Already have Python 3.12? pip install digitorn (or uv tool install digitorn) works too. Then:

digitorn service install
digitorn service start

First steps

digitorn doctor                       # check the environment
digitorn init my-app && cd my-app     # scaffold a project
digitorn dev deploy app.yaml          # push it to the local daemon
digitorn dev chat my-app              # interactive chat

Documentation: docs.digitorn.ai.

Requirements

• Windows 10+, macOS 12+, or a recent Linux distro
• Python 3.12 (the installer fetches it via uv if missing)
• 2 GB free disk space for the model cache (embeddings, ONNX runtimes)
• Outbound HTTPS for LLM providers and MCP servers you choose to use

Operating the daemon

digitorn service status               # is it running?
digitorn service logs                 # last 50 lines
digitorn service stop                 # stop until next boot
digitorn service start                # start again
digitorn service uninstall            # remove the service

Logs live under:

• Windows: Event Viewer (Applications and Services Logs > DigitornDaemon)
• macOS: ~/Library/Logs/digitorn/
• Linux: journalctl --user -u digitorn

The daemon also writes its own structured logs to ~/.digitorn/logs/.

Development

This repository is the source for the daemon and the language. To work on it directly:

git clone https://github.com/mbathe/digitorn-bridge
cd digitorn-bridge
uv sync                               # or: poetry install
uv run digitorn start                 # foreground, with the venv's deps

Documentation is built with Docusaurus under docs-site/ (cd docs-site && npm install && npm start). The web client lives in a separate repository.

License

Apache 2.0. See LICENSE.