NVIDIA-labs OO Agents: Native Python Object-Oriented Agents

Hugging Face Daily Papers Papers
nvidia object-oriented-agents python-framework ai-agents llm model-agnostic software-engineering

Summary

NVIDIA Object-Oriented Agents (NOOA) proposes a Python framework where agents are Python objects, with methods as actions and docstrings as prompts, enabling reliable, testable AI agents using familiar programming paradigms.

Traditional agent development is split across prompt templates, tool schemas, callback code, and workflow graphs. We present NVIDIA Object-Oriented Agents (NOOA), a model-agnostic Python framework for building reliable AI agents. NOOA takes a simpler approach: an agent is a Python object. Its methods are the actions the model can take, fields are its state, docstrings are its prompts, and its type annotations are contracts. A method whose code body consists of "..." is completed at runtime by an LLM-driven agent loop, while methods with normal bodies remain standard deterministic Python. This gives developers and agents the same interface, so agent behavior can be tested, traced, refactored, and improved just like other software. This paper makes three contributions. (1) We present the agent-as-a-Python-object programming model and the design principles behind it. Where Python has existing abstractions, we adopt them directly. Agent-specific capabilities--context, events, state rendering, long-term memory, and validated LLM loops--are exposed through simple Pythonic APIs, so both developers and agents share one familiar programming model. (2) We identify six model-facing ideas that NOOA is, to our knowledge, the first to combine on a single surface: typed input/output, pass-by-reference over live objects, code as action, programmable loop engineering, explicit object state, and model-callable harness APIs for context and events. We find the community already converging on several of these ideas--often as experimental or partial features--and present the comparison to encourage further adoption. (3) We demonstrate that current models use this interface effectively, both in targeted capability tests and on agentic and reasoning benchmarks such as SWE-bench Verified and Terminal-Bench 2.0 and ARC-AGI-3.
Original Article
View Cached Full Text

Cached at: 07/24/26, 05:06 AM

Paper page - NVIDIA-labs OO Agents: Native Python Object-Oriented Agents

Source: https://huggingface.co/papers/2607.20709 Authors:

,

,

,

,

,

,

,

,

,

,

,

,

,

Abstract

Traditionalagentdevelopmentissplitacrossprompttemplates,toolschemas,callbackcode,andworkflowgraphs.WepresentNVIDIAObject-OrientedAgents(NOOA),amodel-agnosticPythonframeworkforbuildingreliableAIagents.NOOAtakesasimplerapproach:anagentisaPythonobject.Itsmethodsaretheactionsthemodelcantake,fieldsareitsstate,docstringsareitsprompts,anditstypeannotationsarecontracts.Amethodwhosecodebodyconsistsof“...“iscompletedatruntimebyanLLM-drivenagentloop,whilemethodswithnormalbodiesremainstandarddeterministicPython.Thisgivesdevelopersandagentsthesameinterface,soagentbehaviorcanbetested,traced,refactored,andimprovedjustlikeothersoftware.Thispapermakesthreecontributions.(1)Wepresenttheagent-as-a-Python-objectprogrammingmodelandthedesignprinciplesbehindit.WherePythonhasexistingabstractions,weadoptthemdirectly.Agent-specificcapabilities--context,events,staterendering,long-termmemory,andvalidatedLLMloops--areexposedthroughsimplePythonicAPIs,sobothdevelopersandagentsshareonefamiliarprogrammingmodel.(2)Weidentifysixmodel-facingideasthatNOOAis,toourknowledge,thefirsttocombineonasinglesurface:typedinput/output,pass-by-referenceoverliveobjects,codeasaction,programmableloopengineering,explicitobjectstate,andmodel-callableharnessAPIsforcontextandevents.Wefindthecommunityalreadyconvergingonseveraloftheseideas--oftenasexperimentalorpartialfeatures--andpresentthecomparisontoencouragefurtheradoption.(3)Wedemonstratethatcurrentmodelsusethisinterfaceeffectively,bothintargetedcapabilitytestsandonagenticandreasoningbenchmarkssuchasSWE-benchVerifiedandTerminal-Bench2.0andARC-AGI-3.

View arXiv pageView PDFAdd to collection

Get this paper in your agent:

hf papers read 2607\.20709

Don’t have the latest CLI?curl \-LsSf https://hf\.co/cli/install\.sh \| bash

Models citing this paper0

No model linking this paper

Cite arxiv.org/abs/2607.20709 in a model README.md to link it from this page.

Datasets citing this paper0

No dataset linking this paper

Cite arxiv.org/abs/2607.20709 in a dataset README.md to link it from this page.

Spaces citing this paper0

No Space linking this paper

Cite arxiv.org/abs/2607.20709 in a Space README.md to link it from this page.

Collections including this paper0

No Collection including this paper

Add this paper to acollectionto link it from this page.

Similar Articles

Nvidia AI - Object Oriented Agents Intro

Reddit r/ArtificialInteligence

Nvidia's open-source object-oriented agent framework allows developers to define agents as Python classes, using docstrings as prompts and return type annotations as structured output, simplifying the development of LLM applications.

openai/openai-agents-python

GitHub Trending (daily)

OpenAI releases openai-agents-python, a lightweight framework for building multi-agent workflows that supports OpenAI APIs and 100+ other LLMs. The SDK includes features like sandbox agents, tools, guardrails, human-in-the-loop, tracing, and realtime voice agent capabilities.