Rienda Rienda Rienda

Documentation

Rienda is a simple, declarative, multi-agent LLM harness. You describe an agent in a Markdown file, Rienda runs it against the provider you configure, and the whole conversation is stored as a session you can reopen.

How to read this documentation

Start with installation, then read the advanced section only when you want to extend Rienda beyond its built-in behavior:

  1. Installation covers the installers, the prebuilt binaries, the Docker image, and building from source.
  2. Advanced explains the JavaScript extensions: the tools the model can call and the hooks that run at fixed points of a run.

The three moving parts

Everything in Rienda reduces to three inputs, and it helps to keep them separate in your head from the beginning:

  • Configuration (~/.rienda/config.yaml) declares the providers Rienda talks to and the models it may run, with their generation settings. It is the single place where connection details and sampling parameters live.
  • Agent definitions (~/.rienda/agents/*.md) are Markdown files whose YAML frontmatter declares the description, the model, and the tools and hooks the agent may use, and whose body is the system prompt. An agent is the unit you run.
  • Sessions (~/.rienda/sessions) are the transcripts Rienda writes as you work. They are what the start list offers back, and they let a conversation be continued, branched, or read again later.

The rest of this documentation is what those three statements mean in practice.

Where to go next