Forge API Demo: official Nous Research repo for Hermes Agent

Nous Research demo CLI for Forge API reasoning completions, with Hermes-3-70b as orchestrator

What Forge API Demo does

The CLI sends a prompt to the Forge API, which runs asynchronously, and then waits for the completion. Options include a reasoning speed preset (fast, medium or slow, defaulting to medium) and a track flag that returns detailed, very verbose reasoning logs. The API key is passed in the FORGE_API_KEY environment variable, and the file to read first is src/forge-api-demo/cli.py.

The README prints full example outputs. In the sample configuration the orchestrator model is Hermes-3-70b, the reasoning models include claude-3-5-sonnet, gemini-1.5-pro and Hermes-3-70b, and the run uses 12 simulations with a maximum depth of 10. The answer text sits under result.choices[0].message.content. Links point to an About Forge API gist and the API reference. The repository was last pushed in November 2024.

Key features

Prompt option and reasoning-speed presets fast, medium and slow
Track flag for detailed reasoning logs
Asynchronous flow that starts a job and waits for the result
Printed example outputs with and without tracking
Poetry-based setup

When to use it

Learning how to call the Forge API asynchronously
Reading a minimal client as a template for your own integration

Who it is for: Developers who want a minimal example of calling Nous Research's Forge API.

How it fits with Hermes Agent

An official Nous Research repository related to Hermes models rather than Hermes Agent. The sample output shows Hermes-3-70b as the orchestrator model.

How to install Forge API Demo

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

curl -sSL https://install.python-poetry.org | python3 -
poetry install

Requirements: Poetry and a Forge API key set as the FORGE_API_KEY environment variable

Note: Last pushed in November 2024, and running it needs a Forge API key.

FAQ

What is Forge API Demo?

Forge API Demo is a short Python CLI from Nous Research that triggers a reasoning completion on the Forge API and waits for the result. It is meant as a code example.

Does Forge API Demo work with Hermes Agent?

No. It is a client demo for the Forge API, not a Hermes Agent integration. Its example output does show the Hermes-3-70b model configured as the orchestrator.

What do I need to run Forge API Demo?

You need Poetry to install the dependencies and a Forge API key supplied in the FORGE_API_KEY environment variable. The demo is run with poetry run python src/forge-api-demo/cli.py -p followed by your prompt.