Orla is a unix tool for running lightweight open-source agents. It is easy to add to a script, use with pipes, or build things on top of.
Installing without local Ollama (docker or system)
If you already have a remote Ollama server or prefer to manage Ollama separately, you can skip the local Ollama installation:
Using the install script:
curl -fsSL https://raw.githubusercontent.com/dorcha-inc/orla/main/scripts/install.sh | sh -s -- --skip-ollama
After installation, configure Orla to use your remote Ollama server by setting either the OLLAMA_HOST or the ORLA_OLLAMA_HOST environment variable, or using the llm_backend configuration in your orla.yaml:
export ORLA_OLLAMA_HOST=http://your-ollama-server:11434
Example Configuration
Create an orla.yaml file in your project directory:
# Server mode configuration
tools_dir: ./tools
port: 8080
timeout: 30
log_format: json
log_level: info
# Agent mode configuration
model: ollama:llama3
max_tool_calls: 10
streaming: true
output_format: auto
confirm_destructive: true
show_thinking: false
show_tool_calls: true
You can also set configuration via environment variables. For example:
export ORLA_PORT=3000 export ORLA_MODEL=ollama:qwen3:1.7b export ORLA_SHOW_TOOL_CALLS=true