Skip to content

Ranya

Getting Started

harunnryd/ranya

Getting Started¶

This guide gets you to a working agent quickly.

Prerequisites¶

Go version from go.mod (currently 1.24.13).
Vendor API keys if you run real providers.

Install¶

go get github.com/harunnryd/ranya

Run the Example¶

go run ./examples/hvac --config examples/hvac/config.yaml

Wire Your Own Engine¶

package main

import (
  "context"
  "log"
  "os"
  "os/signal"

  "github.com/harunnryd/ranya/pkg/ranya"
)

func main() {
  cfg, err := ranya.LoadConfig("config.yaml")
  if err != nil {
    log.Fatal(err)
  }

  engine := ranya.NewEngine(ranya.EngineOptions{Config: cfg})

  ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt)
  defer stop()

  if err := engine.Start(ctx); err != nil {
    log.Fatal(err)
  }

  <-ctx.Done()
  _ = engine.Stop()
}

Next¶