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
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`.fixUpdate `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.fixReview 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.fixAlways 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.