Use the mini-SWE-agent Adapter

Use the NVIDIA NeMo Fabric nvidia.fabric.mini-swe-agent adapter to run tasks with mini-SWE-agent.

Install the Adapter

To install the NVIDIA NeMo Fabric runtime, adapter, and supported mini-SWE-agent package in one environment, run:

$
pip install "nemo-fabric[mini-swe-agent]"

To install the adapter and supported mini-SWE-agent package without the NVIDIA NeMo Fabric runtime, use the harness extra:

$
pip install "nemo-fabric-adapters-mini-swe-agent[harness]"

The harness and full extras install the latest compatible mini-SWE-agent 2.x release. To use an environment-managed compatible package, install the bare adapter:

$
pip install nemo-fabric-adapters-mini-swe-agent

For separate runtime and adapter environments, set ADAPTER_PYTHON in the runtime environment to the adapter environment’s Python interpreter. Use matching NVIDIA NeMo Fabric release versions for the runtime and adapter unless you have validated a different pairing.

Configure the Adapter

Select the mini-SWE-agent harness by adapter ID:

1
from nemo_fabric import HarnessConfig
2
3
harness = HarnessConfig(
4
    adapter_id="nvidia.fabric.mini-swe-agent",
5
    settings={"timeout": 30},
6
)

The adapter supports models, models.base_url, models.temperature, instructions.system, runtime.max_turns, and environment.workspace. Set models.<role>.api_key_env to the environment variable containing the model-provider credential.

runtime.timeout_seconds sets the NVIDIA NeMo Fabric invocation deadline. Use harness.settings.timeout to set the maximum duration of one command; the default is 30 seconds.

This adapter does not support MCP, skills, tool policy, streaming, or telemetry output.

Run a Task

1
import asyncio
2
3
from nemo_fabric import EnvironmentConfig, Fabric, FabricConfig, HarnessConfig
4
from nemo_fabric import InstructionConfig, InstructionsConfig, MetadataConfig
5
from nemo_fabric import ModelConfig, RuntimeConfig
6
7
config = FabricConfig(
8
    metadata=MetadataConfig(name="mini-swe-agent"),
9
    harness=HarnessConfig(
10
        adapter_id="nvidia.fabric.mini-swe-agent",
11
        settings={"timeout": 30},
12
    ),
13
    models={
14
        "default": ModelConfig(
15
            provider="nvidia",
16
            model="nvidia/nemotron-3-nano-omni-30b-a3b-reasoning",
17
            api_key_env="NVIDIA_API_KEY",
18
            base_url="https://integrate.api.nvidia.com/v1",
19
        )
20
    },
21
    instructions=InstructionsConfig(
22
        system=InstructionConfig(content="Inspect the issue and verify the change.")
23
    ),
24
    runtime=RuntimeConfig(max_turns=50, timeout_seconds=1800),
25
    environment=EnvironmentConfig(provider="local", workspace="/workspace"),
26
)
27
28
async def main():
29
    return await Fabric().run(
30
        config, base_dir="/workspace", input="Fix the failing test."
31
    )
32
33
34
result = asyncio.run(main())

The result includes the submitted final output and API-call usage.