mrkeyoor.com_
Mon 02 Nov 19:03 UTC
LLM Toolsevaluationupdated 31 Oct 2026

agent-lightning review

Consider Microsoft Agent Lightning when you need training data from an existing agent's tools and execution flow and can operate the GPU training stack. Agent Lightning separates agent execution from policy training through a trainer, API gateway and rollout controller. Our September 18, 2026 sandbox run at commit ff94575 covered installation, build and tests. It did not establish that a training workload completed.

+48stars / 7d
Verdict

Evaluate Microsoft Agent Lightning when preserving an existing agent's execution flow is a training requirement and you can validate the GPU stack. Our September 18, 2026 run at commit ff94575 recorded a 20-second installation and a separate 1-second build. The test command exited 1, with both collection errors reporting missing numpy. Investigate that dependency problem and complete a small training workload before deciding to adopt it.

We ran it

Lab card: what happened when we ran agent-lightningScreenshot of agent-lightning (microsoft.github.io/agent-lightning)
Install✓ · 20s83 packages · 203 MB
Build✓ · 1s
Tests✗ · 8s82 passed · 0 failed · 2 skipped · 2 errors of 84 (pytest)
Known vulns1(pip-audit)
Repo164 files~14,049 lines of source · 2.8 MB · 5 CI workflows · tests dir

Answers from our run

Does agent-lightning build from source?

Dependencies installed in 20 seconds (83 packages), and the build succeeded in 1 seconds. We cloned commit ff94575 into a clean Debian container with 3 CPUs and no project-specific setup.

Do agent-lightning's tests pass?

No. The project's own test command finished in 8 seconds and reported 82 passed, 0 failed, 2 skipped, 2 collection errors (pytest).

Does agent-lightning have known vulnerabilities in its dependencies?

pip-audit flagged 1 known advisory in the dependency tree at the time of our run.

Who should not use agent-lightning?

Teams requiring reproduced GPU training results or benchmark improvements from this review.

What are the alternatives to agent-lightning?

TRL, Verl. Evaluate Microsoft Agent Lightning when preserving an existing agent's execution flow is a training requirement and you can validate the GPU stack.

Setup2/5Substantial operational prerequisites: the base installation succeeded, but the documented training route requires coupled CUDA, Verl, vLLM and Torch versions plus a local FlashAttention build. That GPU setup was not validated in the supplied run.
DocsN/AThe README lists component guides and examples, but only the supplied README and setup extracts were inspected. Their coverage does not establish the quality or correctness of the other guides.
CommunityN/AThe upstream README lists three community projects and contribution routes. The supplied evidence does not corroborate adoption scale, community quality or support responsiveness.
Maturity3/5Documented architecture and examples provide a basis for evaluation, but the test command exited 1 and the supplied run does not establish a completed GPU training workload. This is an editorial assessment of unresolved validation.

Discussed on

  1. hnAgent Lightning: Train agents with RL (no code changes needed)98 points
  2. hnAgent Lightning v1.055 points

Who it’s for

ML engineers with an existing agent, a repeatable evaluation and a computable reward.
Researchers who need tool use and environment interactions included in training data.
Teams prepared to configure the documented GPU stack and validate a small training workload.

Who it’s NOT for

Teams requiring reproduced GPU training results or benchmark improvements from this review.
CPU-only teams intending to follow the supplied quick start, which requires one A100 GPU.
Native Windows users expecting the documented local runner to work without a Linux environment such as WSL.
Teams requiring a successful test command before evaluation: our sandbox test command exited 1.

Setup reality

Our September 18, 2026 sandbox run used commit ff94575, 3 CPUs, 8 GB RAM and the ghcr.io/astral-sh/uv:python3.12-bookworm image. Installation recorded 83 packages, 203 MB and 20 seconds. The build command returned zero in 1 second. The test command exited 1 after 8 seconds.

The recorded parser summary contains 82 passed, 0 failed, 2 skipped and 2 errors, with a stored total of 84. These counts do not establish exhaustive unique test coverage. Both named collection errors report a missing numpy module.

The supplied installation guide describes a separate GPU setup with coupled Verl, vLLM and Torch versions and a local FlashAttention build. Our installation and build outcomes do not establish that this GPU setup, inference or policy training worked.

Should you evaluate it?

Evaluate Microsoft Agent Lightning when preserving an existing agent's tools and execution flow is a training requirement and your team can validate the GPU environment. For a training job centered on a model and dataset, compare the requirement with TRL first.

Agent Lightning separates agent execution from policy training through a trainer, API gateway and rollout controller. The README at the measured commit describes a trainer running Verl and vLLM, a gateway capturing model requests, and a controller launching agents locally or as Kubernetes Jobs. Those are documented capabilities; our sandbox did not reproduce a training result.

What the sandbox established

Our run took place on September 18, 2026, at commit ff94575, full SHA ff9457587fb6ec900e16e93be9ad2d77409afa08. Installation recorded 83 packages occupying 203 MB and took 20 seconds. The build command returned zero in 1 second. The test command exited 1 after 8 seconds.

The recorded parser summary contains 82 passed, 0 failed, 2 skipped and 2 errors, with a stored total of 84. The supplied record does not verify exhaustive unique test counts, so the stored total cannot support a passing-test percentage. No new execution or complete-log reconciliation was performed for this correction.

The log tail identifies collection errors in tests/verl/test_agl_rollout_manager.py and tests/verl/test_rollout_level_advantage.py. Both report ModuleNotFoundError: No module named 'numpy'. This identifies a dependency problem to investigate without establishing a defect in the training algorithm. The pytest footer reports 4.42 seconds; the harness records 8 seconds for the command. These are separate timing records.

Pip-audit recorded one advisory and one affected package. The supplied record does not identify the advisory, its severity or the number of packages scanned. Scan coverage is unknown, and this result is not a security assessment.

What the GPU instructions require

The supplied installation guide supports CUDA 12.9 or 13.0. It describes Verl 0.7.1 with vLLM 0.12.0, or Verl 0.8.0 with vLLM 0.20.2, with FlashAttention 2.8.3 built locally. It also says tasks upload logs and trajectories to Weights & Biases by default. Review that destination before using sensitive trajectories.

The supplied quick start requires one machine with one A100 GPU. The quick-start guide also requires the Calc-X dataset and additional example dependencies. Its launcher starts Ray, the model backend, gateway and local controller before running training. That local runner is unsupported on native Windows; the guide directs Windows users to a Linux environment such as WSL.

Both supplied setup extracts display a development-documentation warning despite their stable URLs. Their instructions are not verified compatibility evidence for the exact measured commit. The sandbox record does not establish a completed Calc-X rollout, GPU inference, policy update, Kubernetes Job or improvement on a held-out benchmark.

Compare the training layer you need

TRL provides trainers for supervised fine-tuning, GRPO and DPO. Its README describes training language models or adapters on a custom dataset. Evaluate that approach when your job centers on a model and dataset. The supplied evidence does not establish TRL as a drop-in replacement for Agent Lightning's existing-agent integration, and we did not compare setup time or training performance.

Verl is Agent Lightning's documented training backend. Its README describes RL dataflows and modular integration with training and inference frameworks. Direct integration is an engineering option for teams intending to own that work. Treat Verl as a component of the documented Agent Lightning stack, rather than assuming it replaces the gateway and rollout controller.

What to verify next

Reproduce the two collection errors in your intended environment and check the missing dependency against the installation instructions. Obtain the recorded audit advisory before judging its significance.

Then validate a small Calc-X workload through agent execution, captured interactions, reward calculation and a policy update. Check cleanup and logging destinations during the trial. Use a held-out evaluation to decide whether training improves your agent. These are proposed evaluation steps, not results from our sandbox.

Editorial assessments

Setup ease is assessed at 2/5 because the documented training route requires a coupled GPU environment and a local FlashAttention build that our run did not validate. Maturity is assessed at 3/5 because the supplied architecture and examples provide a basis for evaluation, while the nonzero test outcome and missing workload validation leave adoption questions unresolved. These are editorial judgments, not performance measurements.

Documentation and community are unassessed. The measured-commit README lists installation, quick start, trainer, gateway, controller and asynchronous-training guides plus examples. Only the supplied README and setup extracts were inspected; a guide index does not establish documentation quality across those topics. The README also lists DeepWerewolf, AgentFlow and Youtu-Agent and provides contribution routes. Those upstream listings do not establish adoption scale, community quality or support responsiveness.

Alternatives

ProjectWhat it isPick it when
TRLA model post-training library with trainers for SFT, GRPO and DPO.Evaluate it when your job centers on a model and dataset. The supplied evidence does not establish it as a drop-in replacement for Agent Lightning's existing-agent integration.
Verl gh↗The RL training library used as Agent Lightning's documented training backend.Use it within the documented stack, or evaluate direct integration when you intend to own the rollout and training dataflow. Do not assume it replaces Agent Lightning's gateway and controller.

What people are saying

  1. [github-trending] microsoft/agent-lightning

Sources

  1. Agent Lightning README
  2. Agent Lightning installation guide
  3. Agent Lightning quick start
  4. Agent Lightning v1.0.1 release
  5. Issue 567: Kubernetes image readiness
  6. Issue 592: custom tool parser plugins
  7. Issue 593: per-rollout loss scaling

More llm tools reviews

FreeToken · ironclaw · infinity · Claude-Code-Game-Studios · OmniRoute · harnessrouter · the whole board →