/ 
Langertha-0.200
/ Langertha::Engine::NousResearch

NAME

Langertha::Engine::NousResearch - Nous Research Inference API

VERSION

version 0.200

SYNOPSIS

use Langertha::Engine::NousResearch;

my $nous = Langertha::Engine::NousResearch->new(
    api_key => $ENV{NOUSRESEARCH_API_KEY},
    model   => 'Hermes-3-Llama-3.1-70B',
);

print $nous->simple_chat('Explain the Hermes prompt format');

# MCP tool calling (hermes_tools enabled by default)
use Future::AsyncAwait;

my $nous = Langertha::Engine::NousResearch->new(
    api_key     => $ENV{NOUSRESEARCH_API_KEY},
    model       => 'Hermes-3-Llama-3.1-70B',
    mcp_servers => [$mcp],
);

my $response = await $nous->chat_with_tools_f('Add 7 and 15');

DESCRIPTION

Provides access to Nous Research's inference API. Extends Langertha::Engine::OpenAI with Nous's endpoint (https://inference-api.nousresearch.com/v1) and Hermes tool calling.

Available models: Hermes-3-Llama-3.1-70B (default), Hermes-3-Llama-3.1-405B, Hermes-4-70B, Hermes-4-405B, DeepHermes-3-Mistral-24B-Preview.

hermes_tools is enabled by default. Tool descriptions are injected into the system prompt as <tools> XML, and <tool_call> tags are parsed from the model output. No server-side tool calling support required. See Langertha::Role::Tools for customization options.

Get your API key at https://portal.nousresearch.com/ and set LANGERTHA_NOUSRESEARCH_API_KEY.

THIS API IS WORK IN PROGRESS

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudss.us/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.