Registry / ai-ml / google-tunix

google-tunix

JSON →
library0.1.7pypypi✓ verified 82d ago

Google Tunix (current version 0.1.6) is a lightweight, JAX-native framework designed for post-training Large Language Models (LLMs) using both reinforcement learning (RL) and supervised fine-tuning (SFT). It provides powerful tools for researchers and production teams to achieve maximum control and scalability when aligning and improving foundation models, particularly on accelerators like TPUs. Releases are frequent, focusing on new model support, API stability, and performance enhancements.

pip install google-tunix
INSTALL
IMPORT
SIG · GOOGLE-TUNIX
G
google-tunix
ai-mlpythonv0.1.7
Install
54.2s avg
Import
Disk
1570MB
Pass rate
3/ 10
Env Coverage3 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.1.7 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✕ build_error
✕ build_error
py 3.11
✕ build_error
✓ 54.25s
py 3.12
✕ build_error
✓ 55.2s
py 3.13
✕ build_error
✓ 53.1s
py 3.9
✕ build_error
✕ build_error
1570MB installed
● package 1570MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

GrpoConfig
from tunix import GrpoConfig
from tunix.configs import GrpoConfig

This quickstart demonstrates how to initialize a basic `AgenticGRPOConfig`, which is central to defining Agentic Reinforcement Learning from Human Feedback (RLHF) training parameters in Tunix. This config would typically be passed to an `AgenticGRPOLearner` along with actual JAX/Flax models and data for a full training workflow.

from tunix import AgenticGRPOConfig # Configure Agentic GRPO for LLM post-training # This is a minimal configuration; a real setup would require more specific parameters # like model_config, optimizers, and potentially a tokenizer. agentic_grpo_config = AgenticGRPOConfig( num_generations=2, # Number of generations per iteration num_iterations=10, # Total training iterations max_response_length=512, # Maximum length for generated responses beta=0.1, # KL-divergence coefficient # Placeholders for complex objects; in a real scenario these would be actual config objects model_config=None, # e.g., Llama2Config, GemmaConfig optimizer_config_factory=lambda: None, # Factory for optimizer configs ) print(f"AgenticGRPOConfig initialized with num_generations: {agentic_grpo_config.num_generations}") print(f"Max response length: {agentic_grpo_config.max_response_length}") # Note: To run a full training loop, you would also need to instantiate # AgenticGRPOLearner with actual JAX/Flax models, a tokenizer, and a dataset.
Debug
Known issues
breakingThe `GrpoLearner` constructor changed the parameter name for the main configuration object from `grpo_config` to `algo_config`.
fix
Update `rl_trainer = GrpoLearner(grpo_config=grpo_config)` to `rl_trainer = GrpoLearner(algo_config=grpo_config)`.
affects: v0.1.4 to v0.1.5 (fixed in v0.1.5)
breakingAPI changes were introduced for distributed training components, specifically impacting `rl_cluster_lib.ClusterConfig` and related utilities.
fix
Review the latest Tunix examples and documentation (especially for v0.1.4+) for updated module paths and class signatures related to distributed training and cluster configuration.
affects: v0.1.3 to v0.1.4
gotchaAs a JAX-native library, Tunix requires specific versions of JAX and Flax. Mismatched versions, especially with `jaxlib` for your accelerator (CPU/GPU/TPU), can lead to complex installation issues and runtime errors.
fix
Always install JAX/Flax versions compatible with your hardware and the Tunix release. Check Tunix's `pyproject.toml` or `setup.py` for exact dependencies, and consult JAX's official documentation for correct `jaxlib` installation for your device.
affects: All versions
Upgrade
Version history
0.1.7latest on PyPI · released Jun 11, 2026
Audit
Dependencies
jaxrequiredCore machine learning framework, Tunix is JAX-native.
flaxrequiredNeural network library for JAX, often used with Tunix models.
pythonrequiredRequired Python version.
Agent activity
18 hits · last 30 days
node
16
OpenAI (training)
1
Resources
google-tunix — pip install google-tunix · libregistry