{"id":27190,"library":"nvidia-nat-core","title":"NVIDIA NeMo Agent Toolkit Core Library","description":"Core library for NVIDIA NeMo Agent Toolkit, providing foundational components for building, training, and deploying conversational AI agents. Current version 1.6.0, requires Python 3.11+. Release cadence is irregular, tied to NeMo framework updates.","status":"active","version":"1.6.0","language":"python","source_language":"en","source_url":"https://github.com/NVIDIA/NeMo-Agent-Toolkit","tags":["nvidia","nemo","agent","conversational-ai","llm"],"install":[{"cmd":"pip install nvidia-nat-core","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for tensor operations and neural network components","package":"torch","optional":true}],"imports":[{"note":"Correct import path","symbol":"NeMoAgent","correct":"from nvidia_nat_core import NeMoAgent"},{"note":"Configuration class","symbol":"AgentConfig","correct":"from nvidia_nat_core.config import AgentConfig"}],"quickstart":{"code":"from nvidia_nat_core import NeMoAgent\nfrom nvidia_nat_core.config import AgentConfig\n\nconfig = AgentConfig(model=\"meta/llama-3.1-8b\", api_key=os.environ.get('NVIDIA_API_KEY', ''))\nagent = NeMoAgent(config)\nresponse = agent.query(\"Hello, how are you?\")\nprint(response)","lang":"python","description":"Initialize an agent with config and query."},"warnings":[{"fix":"Change `import nat_core` to `from nvidia_nat_core import ...`.","message":"The `nat_core` top-level import is deprecated; use `nvidia_nat_core` instead.","severity":"deprecated","affected_versions":"<=1.4.0"},{"fix":"Upgrade Python to 3.11 or higher.","message":"Requires Python 3.11+. Older Python versions will cause installation failure.","severity":"breaking","affected_versions":">=1.5.0"},{"fix":"Set `NVIDIA_API_KEY` environment variable or pass `api_key` in `AgentConfig`.","message":"API key must be set via environment variable `NVIDIA_API_KEY` or passed in config; otherwise agent creation fails silently.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install nvidia-nat-core`.","cause":"Package not installed or installed with wrong name.","error":"ModuleNotFoundError: No module named 'nvidia_nat_core'"},{"fix":"Upgrade to latest version: `pip install --upgrade nvidia-nat-core`.","cause":"Outdated version where the class had a different name.","error":"ImportError: cannot import name 'NeMoAgent' from 'nvidia_nat_core'"},{"fix":"Set the environment variable `NVIDIA_API_KEY` or provide `api_key` in `AgentConfig`.","cause":"Missing NVIDIA API key.","error":"RuntimeError: Agent initialization failed: 'api_key' is required"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}