google-tunix 0.1.7

A lightweight JAX-native LLM post-training framework.

Tunix: A Lightweight LLM Post-Training Library

Tunix (Tune-in-JAX) is a JAX based library designed to streamline the post-training of Large Language Models. It provides efficient and scalable support for:

• SOTA Training performance on TPUs
• Supervised Fine-Tuning
• Reinforcement Learning (RL)
• Agentic RL

Tunix leverages the power of JAX for accelerated computation and seamless integration with JAX-based modeling frameworks like Flax NNX, and integrates with high-performance inference engines like vLLM and SGLang-JAX for rollout. For our detailed documentation, please refer to the Tunix Website.

Current Status: V2 Release

Tunix is under active development. Our team is actively working on expanding its capabilities, usability and performance. Stay tuned for upcoming updates and new features! See Talks and Announcements for latest updates, talks, and blog posts.

High Level Architecture

Tunix serves as a state-of-the-art post-training library within the JAX training stack, positioned to leverage foundational tools like Flax, Optax, Orbax, etc. for efficient model refinement. It sits as an intermediate layer between these core utilities and optimized models like MaxText and MaxDiffusion, streamlining tuning workflows on top of the XLA and JAX infrastructure. See Design Overview for more details on the architecture.

Key Features

• Supervised Fine-Tuning (SFT):
  • Full Weights Fine-Tuning
  • PEFT (Parameter-Efficient Fine-Tuning)
  • DPO (Direct Preference Optimization)
  • ORPO (Odds Ratio Preference Optimization)
• Reinforcement Learning (RL):
  • PPO (Proximal Policy Optimization)
  • GRPO (Group Relative Policy Optimization)
  • GSPO-Token (Token-level Group Sequence Policy Optimization)
  • DAPO (Direct Alignment via Preference Optimization)
  • Dr.GRPO (Distributionally Robust GRPO)
• Agentic RL:
  • Multi-turn tool use
  • Asynchronous rollout for high-throughput trajectory collection
  • Trajectory batching and grouping

News

• [2026/04] Gemma4 models are supported in Tunix! Stay tuned for upcoming training recipes.
• [2026/01] Tunix model now supports efficient kernel execution (splash attn, GMM MoE).
• [2025/12] Agentic RL Training has been released, with efficient support of multi-turn agent-env interaction, tool usage, async rollout, etc.

Framework & Infra Highlights

• Modularity:
  • Components are designed to be reusable and composable
  • Easy to customize and extend
• Performance & Efficiency:
  • Native vLLM and SGLang-JAX on TPU integration for performant rollout
  • Native MaxText model integration for high performance kernels and model execution
  • Micro-batching support for component level efficient execution
• Stability
  • Seamless multi-host distributed training with Pathways which can scale up to thousands of devices
  • Checkpointing and Fault Tolerance

Getting Started

Installation: Jump to Installation to install Tunix and run your first training job.

For TPU users integrating vllm and tpu-inference, there are two supported setup paths:

• Docker image builds use Dockerfile and install the pinned dependencies directly from requirements/requirements.txt and requirements/special_requirements.txt.
• Local TPU VM or developer-machine installs can use scripts/install_tunix_vllm_requirement.sh, which installs the same requirement files outside Docker.

These are separate entry points. If you are building the Docker image, you do not need to run the install script inside the container build.

Examples: To get started, we have a number of detailed examples and tutorials. You can see Quick Start for a great set of starting examples and Examples and Guides for a comprehensive list of all the notebooks and examples we have.

Supported Models

Tunix supports a growing list of models including Gemma, Llama, and Qwen families. See Models for a full list and details on how to add new ones.

Contributing and Feedback

We welcome contributions! As Tunix is in early development, the contribution process is still being formalized. The detailed contribution process is outlined here. In the meantime, you can make feature requests, report issues and ask questions in our Tunix GitHub discussion forum.

Collaborations and Partnership

GRL (Game Reinforcement Learning), developed by Hao AI Lab from UCSD, is an open-source framework for post-training large language models through multi-turn RL on challenging games. In collaboration with Tunix, GRL integrates seamless TPU support—letting users quickly run scalable, reproducible RL experiments (like PPO rollouts on Qwen2.5-0.5B-Instruct) on TPU v4 meshes with minimal setup. This partnership empowers the community to push LLM capabilities further, combining Tunix’s optimized TPU runtime with GRL’s flexible game RL pipeline for cutting-edge research and easy reproducibility.

Citing Tunix

@misc{tunix2025,
  title={Tunix (Tune-in-JAX)},
  author={Bao, Tianshu and Carpenter, Jeff and Chai, Lin and Gao, Haoyu and Jiang, Yangmu and Noghabi, Shadi and Sharma, Abheesht and Tan, Sizhi and Wang, Lance and Yan, Ann and Yu, Weiren and others},
  year={2025},
  howpublished={\url{https://github.com/google/tunix}},
}

Acknowledgements

Thank you to all our wonderful contributors!