Hermes · Python Library

Import it. Call it. Ship it inside your app.

Hermes is a library, not just a CLI. from run_agent import AIAgent, create AIAgent(model=..., quiet_mode=True), and agent.chat("...") runs the full tool loop and returns a string. Always set quiet_mode=True when embedding, or CLI spinners pollute your output. For more control, run_conversation() returns a dict with final_response and messages; pass conversation_history back for stateful multi-turn. enabled_toolsets / disabled_toolsets control capabilities; skip_memory and skip_context_files make a clean stateless endpoint. It drops straight into a FastAPI route, a Discord bot, or a CI step. One gotcha: an AIAgent holds state, so create a fresh one per thread or task, never shared.