/ 
Langertha-0.304
River stage one • 1 direct dependent • 1 total dependent

Changes for version 0.304 - 2026-03-07

  • New role: Langertha::Role::HermesTools — extracted Hermes-style XML tool calling into a dedicated role. Engines compose this role instead of setting a hermes_tools flag. Cleaner polymorphic dispatch: Role::Tools provides the tool loop and default native API path, HermesTools overrides build_tool_chat_request to inject tools into the system prompt.
  • Role::Tools cleaned up: removed all hermes branching, private _hermes_* methods, and hermes_tools attribute. Five polymorphic methods (format_tools, response_tool_calls, extract_tool_call, format_tool_results, response_text_content) are now provided by either the engine (native) or HermesTools (XML).
  • AKI.pm (native API): added tool calling support via HermesTools role with hermes_extract_content override for AKI's response format.
  • AKIOpenAI.pm: composes HermesTools role (replaces hermes_tools flag).
  • NousResearch.pm: composes HermesTools role (replaces hermes_tools flag).
  • Raider and Chat: simplified tool loop — removed all hermes if/else branching, uses polymorphic build_tool_chat_request.

Documentation

langertha_chat_ollama
Simple chat with Ollama
langertha_chat_openai
Simple chat with OpenAI
langertha_list_models
Simple script to check the model list on an OpenAI compatible API
langertha_whisper
Simple transcription with a Whisper compatible server or OpenAI

Modules

Langertha
The clan of fierce vikings with 🪓 and 🛡️ to AId your rAId
Langertha::Chat
Chat abstraction wrapping an engine with optional overrides
Langertha::Embedder
Embedding abstraction wrapping an engine with optional model override
Langertha::Engine::AKI
AKI.IO native API
Langertha::Engine::AKIOpenAI
AKI.IO via OpenAI-compatible API
Langertha::Engine::Anthropic
Anthropic API
Langertha::Engine::Cerebras
Cerebras Inference API
Langertha::Engine::DeepSeek
DeepSeek API
Langertha::Engine::Gemini
Google Gemini API
Langertha::Engine::Groq
GroqCloud API
Langertha::Engine::HuggingFace
HuggingFace Inference Providers API
Langertha::Engine::LlamaCpp
llama.cpp server
Langertha::Engine::MiniMax
MiniMax API (Anthropic-compatible)
Langertha::Engine::Mistral
Mistral API
Langertha::Engine::NousResearch
Nous Research Inference API
Langertha::Engine::Ollama
Ollama API
Langertha::Engine::OllamaOpenAI
Ollama via OpenAI-compatible API
Langertha::Engine::OpenAI
OpenAI API
Langertha::Engine::OpenAIBase
Base class for OpenAI-compatible engines
Langertha::Engine::OpenRouter
OpenRouter API
Langertha::Engine::Perplexity
Perplexity Sonar API
Langertha::Engine::Remote
Base class for all remote engines
Langertha::Engine::Replicate
Replicate API
Langertha::Engine::Whisper
Whisper compatible transcription server
Langertha::Engine::vLLM
vLLM inference server
Langertha::ImageGen
Image generation abstraction wrapping an engine with optional overrides
Langertha::Plugin
Base class for plugins
Langertha::Plugin::Langfuse
Langfuse observability plugin for any PluginHost
Langertha::Raider
Autonomous agent with conversation history and MCP tools
Langertha::Raider::Result
Result object from a Raider raid
Langertha::RateLimit
Rate limit information from API response headers
Langertha::Request::HTTP
A HTTP Request inside of Langertha
Langertha::Response
LLM response with metadata
Langertha::Role::Chat
Role for APIs with normal chat functionality
Langertha::Role::ContextSize
Role for an engine where you can specify the context size (in tokens)
Langertha::Role::Embedding
Role for APIs with embedding functionality
Langertha::Role::HTTP
Role for HTTP APIs
Langertha::Role::HermesTools
Hermes-style tool calling via XML tags
Langertha::Role::ImageGeneration
Role for engines that support image generation
Langertha::Role::JSON
Role for JSON
Langertha::Role::KeepAlive
Role for engines that support keep-alive duration
Langertha::Role::Langfuse
Langfuse observability integration
Langertha::Role::Models
Role for APIs with several models
Langertha::Role::OpenAICompatible
Role for OpenAI-compatible API format
Langertha::Role::OpenAPI
Role for APIs with OpenAPI definition
Langertha::Role::PluginHost
Role for objects that host plugins (Raider, Engine)
Langertha::Role::ResponseFormat
Role for an engine where you can specify structured output
Langertha::Role::ResponseSize
Role for an engine where you can specify the response size (in tokens)
Langertha::Role::Seed
Role for an engine that can set a seed
Langertha::Role::StaticModels
Role for engines with a hardcoded model list
Langertha::Role::Streaming
Role for streaming support
Langertha::Role::SystemPrompt
Role for APIs with system prompt
Langertha::Role::Temperature
Role for an engine that can have a temperature setting
Langertha::Role::ThinkTag
Configurable think tag filtering for reasoning models
Langertha::Role::Tools
Role for MCP tool calling support
Langertha::Role::Transcription
Role for APIs with transcription functionality
Langertha::Spec::Mistral
Pre-computed OpenAPI operations for Mistral
Langertha::Spec::Ollama
Pre-computed OpenAPI operations for Ollama
Langertha::Spec::OpenAI
Pre-computed OpenAPI operations for OpenAI
Langertha::Stream
Iterator for streaming responses
Langertha::Stream::Chunk
Represents a single chunk from a streaming response
LangerthaX
Bring your own viking!

Examples

Other files