/ 
Langertha-0.202
River stage one • 2 direct dependents • 2 total dependents

Changes for version 0.202 - 2026-02-25

  • Engine base class hierarchy: introduce Engine::Remote (JSON + HTTP
    • url required) and Engine::OpenAIBase (+ OpenAICompatible, OpenAPI, Models, Temperature, ResponseSize, SystemPrompt, Streaming, Chat). All 15 engines now extend these base classes instead of repeating 10+ role composition statements. New engines need only 2-3 lines.
  • Migrate non-OpenAI engines to extend Engine::Remote: Anthropic, Gemini, Ollama, AKI
  • Migrate OpenAI-compatible engines to extend Engine::OpenAIBase: OpenAI, DeepSeek, Groq, Perplexity, Mistral, MiniMax, NousResearch, AKIOpenAI, OllamaOpenAI, vLLM (Whisper inherits via OpenAI)
  • New engine: Cerebras — fastest inference platform (llama-3.3-70b)
  • New engine: OpenRouter — unified gateway for 300+ models
  • New engine: Replicate — thousands of open-source models
  • New engine: LlamaCpp — llama.cpp server with embeddings
  • OpenAICompatible: api_key is now optional (undef = no Authorization header), enabling local engines (vLLM, llama.cpp) without dummy keys
  • OpenAICompatible: model is now optional in requests, enabling single-model servers (vLLM, llama.cpp) without explicit model names
  • Add comprehensive engine hierarchy test (t/10_engine_hierarchy.t) verifying inheritance, role composition, instantiation, and request generation for all 19 engines
  • Raider self-tools: raider_mcp => 1 enables LLM-controlled tools: raider_ask_user, raider_pause, raider_abort, raider_wait, raider_wait_for, raider_session_history, raider_manage_mcps, raider_switch_engine
  • Raider engine_catalog: runtime engine switching via self-tool or API
  • Raider mcp_catalog: dynamic MCP server activation/deactivation
  • Raider inline tools: quick tool definitions without MCP server setup
  • Raider::Result: typed result objects (final, question, pause, abort) with backward-compatible stringification
  • AKI: openai() no longer carries over native model name (different naming between native and /v1 API), uses default model and warns
  • Add live embedding test (t/82_live_embedding.t) with semantic similarity verification via Math::Vector::Similarity for OpenAI, Mistral, Ollama, OllamaOpenAI, and LlamaCpp
  • Add live chat test (t/83_live_chat.t) for all 16 engines including Cerebras, OpenRouter, Perplexity, MiniMax, and LlamaCpp

Documentation

README.md
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::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::LlamaCpp
llama.cpp server
Langertha::Engine::MiniMax
MiniMax API
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::Raider
Autonomous agent with conversation history and MCP tools
Langertha::Raider::Result
Result object from a Raider raid
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::JSON
Role for JSON
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::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::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::Stream
Iterator for streaming responses
Langertha::Stream::Chunk
Represents a single chunk from a streaming response
LangerthaX
Bring your own viking!

Examples

Other files