Overview
CCNets Causal GPT-RL is an Amazon SageMaker training algorithm for building GPT-style reinforcement learning policies from private offline trajectory data.
The algorithm trains an autoregressive decision model from recorded sequences of observations, actions, rewards, and episode boundaries. Similar to how a language model generates the next token from prior tokens, Causal GPT-RL generates actions from accumulated state-action trajectory context.
Unlike approaches that treat each decision as an isolated one-step prediction, Causal GPT-RL uses trajectory context to train policies for long-horizon control and sequential decision-making tasks.
Users provide offline trajectory datasets in Minari format with declared Gymnasium observation and action spaces. These spaces define the input and output structure of the trained policy, including continuous, discrete, MultiDiscrete, MultiBinary, and nested Dict or Tuple spaces.
Training runs as a containerized Amazon SageMaker training job. Users can:
- Upload private offline trajectory datasets to Amazon S3
- Launch training jobs using the SageMaker Algorithm ARN
- Configure supported training hyperparameters
- Validate observation and action schemas at startup
- Monitor training and evaluation metrics through Amazon CloudWatch
- Export trained policy artifacts to Amazon S3
The final training output is a portable Causal GPT-RL policy bundle containing the trained model weights and model configuration. The exported bundle can be loaded directly with the public causal-gpt-rl inference runtime. It can also be converted to ONNX for deployment in external applications, Unity, and other compatible runtime environments.
Causal GPT-RL currently focuses on offline training workflows. Final policy performance should be validated by running the exported bundle in the user's actual simulator, game engine, robotics system, or evaluation environment.
The product is suitable for:
- Offline reinforcement learning
- Simulation and control workflows
- Robotics experimentation
- Gaming AI
- Sequential decision-making benchmarks
- Recorded operational or interaction logs
- Custom decision-model training
Users should be familiar with Amazon SageMaker, reinforcement learning concepts, trajectory datasets, and training job configuration.
Version Compatibility
- AWS Marketplace Training Version: v0-0-9
- Compatible Inference Runtime: causal-gpt-rl v0.13.0
- Output Bundle Format: v2
Resources
-
GitHub Repository and Inference Runtime https://github.com/ccnets-team/causal-gpt-rl
-
AWS Marketplace Training Quick Start https://github.com/ccnets-team/causal-gpt-rl/blob/main/training/docs/aws/aws-marketplace-training.md
-
Hugging Face Demo Models https://huggingface.co/ccnets/causal-gpt-rl
Support
For product support, contact CCNets at support@ccnets.org .
Highlights
- Train reinforcement learning policies using GPT-style autoregressive models.
- Built on Transformer Decoder architecture for sequential state-action context modeling.
- Designed to learn from offline trajectory data without requiring expert-only datasets.
Details
Introducing multi-product solutions
You can now purchase comprehensive solutions tailored to use cases and industries.
Features and programs
Financing for AWS Marketplace purchases
Pricing
Dimension | Description | Cost/host/hour |
|---|---|---|
ml.g5.xlarge Training Recommended | Algorithm training on the ml.g5.xlarge instance type | $4.00 |
ml.m5.xlarge Inference (Batch) Recommended | Model inference on the ml.m5.xlarge instance type, batch mode | $1.00 |
ml.m5.xlarge Inference (Real-Time) Recommended | Model inference on the ml.m5.xlarge instance type, real-time mode | $1.00 |
ml.m5.2xlarge Inference (Batch) | Model inference on the ml.m5.2xlarge instance type, batch mode | $1.00 |
ml.m5.2xlarge Inference (Real-Time) | Model inference on the ml.m5.2xlarge instance type, real-time mode | $1.00 |
ml.m5.4xlarge Inference (Batch) | Model inference on the ml.m5.4xlarge instance type, batch mode | $1.00 |
ml.m5.4xlarge Inference (Real-Time) | Model inference on the ml.m5.4xlarge instance type, real-time mode | $1.00 |
ml.m5.large Inference (Batch) | Model inference on the ml.m5.large instance type, batch mode | $1.00 |
ml.m5.large Inference (Real-Time) | Model inference on the ml.m5.large instance type, real-time mode | $1.00 |
Vendor refund policy
CCNets may review refund requests case by case for duplicate charges, AWS Marketplace billing errors, inability to access the product due to a CCNets-side issue, or confirmed defects in the Marketplace container or product configuration. Refunds are not provided for customer configuration errors, unsupported datasets, dataset quality issues, unmet performance expectations, or successfully completed usage. Requests must be sent within 14 days to support@ccnets.org .
How can we make this page better?
Legal
Vendor terms and conditions
Content disclaimer
Delivery details
Amazon SageMaker algorithm
An Amazon SageMaker algorithm is a machine learning model that requires your training data to make predictions. Use the included training algorithm to generate your unique model artifact. Then deploy the model on Amazon SageMaker for real-time inference or batch processing. Amazon SageMaker is a fully managed platform for building, training, and deploying machine learning models at scale.
Version release notes
This release updates CCNets Causal GPT-RL Training Algorithm to SageMaker Algorithm version cgrl-training-algorithm-v0-0-10 and provides updated training and inference containers for GPT-style offline reinforcement learning.
This release supports fixed-shape Gymnasium observation and action schemas built from one-dimensional Box, Discrete, MultiDiscrete, and MultiBinary leaf spaces. Dict and Tuple containers may be nested and may combine continuous and categorical fields within the same observation or action structure.
Verified exported-bundle combinations include Dict observations that combine Box and Discrete fields, and Tuple or Dict action spaces that combine continuous Box branches with Discrete branches. The same schema system also supports structured Unity ML-Agents datasets such as Tuple observations with Discrete or MultiDiscrete action branches, including egocentric Dict wrappers used by multi-agent environments.
Unity ML-Agents integration follows an offline training workflow. Users collect trajectories from a Unity ML-Agents environment, package the trajectories as Minari-compatible datasets, upload the datasets to Amazon S3, and train the policy through SageMaker. The SageMaker training container does not launch the Unity Editor or execute the customer's Unity build during training.
The public repository includes Unity trajectory collection examples and an ONNX deployment example for running a trained policy against a Unity ML-Agents build. ONNX deployment is a downstream integration example and is separate from the primary SageMaker model.tar.gz output.
Public benchmark resources are available for MuJoCo policy bundles and a Unity ML-Agents Pyramids ONNX policy. Benchmark results are environment-, runtime-, and protocol-specific and should be used as reproducible references rather than guarantees for customer datasets or environments.
The default training configuration is designed to provide a practical starting point for common MuJoCo and Unity ML-Agents workflows. Additional adjustment may still be useful depending on dataset quality, reward scale, trajectory coverage, observation and action design, and environment-specific behavior.
This release adds real-time policy delivery through the SageMaker checkpoint S3 prefix. Complete inference bundles are exported and synchronized to S3 while training is still running, allowing buyers to load and evaluate intermediate policies in their own game engine, simulator, robotics environment, Unity build, or other target environment before the final model artifact is produced.
Intermediate policies are delivered in two checkpoint series. archive/ stores five automatically scheduled points distributed across max_steps and up to ten additional buyer-requested points supplied through archive_steps. Archive points are identified by training step and are preserved permanently. improvements/ stores a rotating ten-slot best-so-far track whenever offline_eval/action_nll reaches a new minimum.
The archive series is the recommended source for measuring policy-performance trends and making early-stopping decisions. offline_eval/action_nll measures how well the model predicts held-out dataset actions and does not guarantee task performance. A lack of new improvement bundles does not mean that environment performance has stopped improving.
Each delivered bundles/*/ directory is a complete inference bundle that can be loaded directly with the public causal-gpt-rl runtime. The paired .pt files contain training, optimizer, and scheduler state for resume or retraining and are not required for normal inference.
The final model artifact remains model.tar.gz and contains reports/summary.json and the canonical inference bundle under <run_namespace>/bundle/. Intermediate archive and improvement bundles are synchronized separately through the configured checkpoint S3 prefix and are not duplicated inside model.tar.gz.
The canonical bundle is selected using offline_eval/action_nll and should be treated as a default policy rather than a guarantee that it is the best policy in the buyer's target environment. Buyers may evaluate preserved archive bundles and deploy the point that performs best under their own evaluation protocol.
CloudWatch Logs report checkpoint and bundle export paths, training steps, export reasons, the checkpoint metric, and metric direction. CloudWatch also displays offline evaluation metrics such as action negative log-likelihood. These metrics are training progress indicators measured against held-out dataset actions and do not guarantee final performance in the buyer's environment.
Real-time policy delivery refers to policy-bundle availability during an active training job. It does not mean that the training container runs the buyer's environment or that every S3 object becomes visible immediately; delivery depends on the SageMaker checkpoint synchronization completing.
The trained policy can be used through a reset, act, and observe rollout loop. The workflow supports state-based behavior control, prompt-like control through buyer-provided instruction vectors, batched rollout handling with per-episode resets, and stable episode boundary handling for cached inference.
Additional details
Inputs
- Summary
This product trains GPT-style reinforcement learning policy models from offline trajectory datasets.
The primary training input is a Minari-compatible offline reinforcement learning dataset provided through the SageMaker training input channel. The training channel should point to an S3 prefix containing one or more Minari dataset directories.
The buyer specifies which datasets to train on using the dataset_ids hyperparameter. Each dataset ID is interpreted as a relative path under the SageMaker training channel root.
The dataset's observation and action spaces define the trained policy interface. Supported fixed-shape leaf spaces are one-dimensional Box, Discrete, MultiDiscrete, and MultiBinary. Dict and Tuple containers may be nested and may combine these leaf types.
This enables hybrid observation and action schemas that mix continuous and categorical fields. Verified combinations include Dict observations containing Box and Discrete fields and Tuple or Dict actions containing both Box and Discrete branches. Structured Unity ML-Agents examples also include Tuple observations paired with Discrete and MultiDiscrete actions, and egocentric Dict wrappers around those structures.
Buyers may include numeric state fields, action masks, goal or mode fields, task IDs, and encoded instruction vectors as part of the observation data when those fields are included in the dataset.
Unity ML-Agents users should collect trajectories from the Unity environment outside the SageMaker training container and package those trajectories as Minari-compatible datasets. SageMaker training uses the uploaded offline dataset and does not launch the Unity Editor or the customer's Unity executable.
For compatible inference and batch transform workflows, the exported model accepts JSON input containing observations, where observations is an ordered list of observation records representing the episode history so far.
The model returns an action for the latest observation in the provided observation history. The exact action structure is determined by the trained bundle; the sample below uses an action vector.
For live intermediate-policy delivery, buyers should configure a SageMaker checkpoint S3 prefix. The archive_steps hyperparameter may optionally request up to ten additional permanent archive points beyond the five points automatically distributed across max_steps. Checkpoint configuration is separate from the Minari training input channel.
- Limitations for input type
- Training input must be ordered offline RL trajectories stored as Minari-compatible dataset directories. dataset_ids must reference paths under the SageMaker training channel root. Supported spaces: 1D Box, Discrete, MultiDiscrete, MultiBinary, and nested Dict/Tuple structures. Hybrid schemas may combine continuous and categorical branches. Multidimensional image Box, Text, Sequence, Graph, OneOf, and variable-length structures are unsupported. Encode raw text, images, audio, or variable-length inputs as fixed-size numeric fields. Unity collects trajectories and evaluates or deploys the policy; SageMaker trains only from uploaded offline data. archive_steps accepts up to 10 comma-separated values. Each must satisfy 0 < step <= max_steps. Duplicates count toward the limit, and invalid values fail the job at startup. A step is a training update, not an episode count. Inference requests must match the trained bundle's dimensions, structure, ordering, bounds, and categorical branches.
- Input MIME type
- application/json
Input data descriptions
The following table describes supported input data fields for real-time inference and batch transform.
Field name | Description | Constraints | Required |
|---|---|---|---|
dataset_ids | Comma-separated Minari dataset IDs to use for training. Each dataset ID is interpreted relative to the SageMaker training channel root. Example: mujoco/humanoid/simple-v0,mujoco/humanoid/medium-v0 | - | Yes |
max_steps | Maximum number of training update steps. Use a smaller value for smoke testing and a larger value for full training workflows. Step means a training-loop update counter, not an episode count. The archive schedule is derived from this value: five points are placed at 20, 40, 60, 80, and 100 percent of max_steps. | - | No |
batch_size | Training minibatch size.
| - | No |
context_length | Number of trajectory steps used as sequential context by the autoregressive policy model during training and bundle export. This is a training hyperparameter, not an inference request field. | - | No |
seed | Random seed used for training reproducibility.
| - | No |
archive_steps | Optional comma-separated training steps to preserve permanently under archive/, in addition to the five automatically scheduled archive points. Up to 10 values are allowed, and each must satisfy 0 < step <= max_steps. Example: 25000,75000 | - | No |
Resources
Support
Vendor support
For product support, contact CCNets at support@ccnets.org .
Website: https://ccnets.org
CCNets provides email-based technical support for this product. Support includes guidance for Amazon SageMaker training job configuration, container usage, supported hyperparameters, CloudWatch log review, S3 model artifact output, and general troubleshooting related to running the algorithm.
This product is intended for technical users familiar with Amazon SageMaker and reinforcement learning workflows. Support does not include custom model development, customer-specific dataset engineering, production system integration, or guaranteed performance tuning unless separately agreed with CCNets.
For enterprise deployment, custom training workflows, or integration support, please contact CCNets to discuss a separate support arrangement.
AWS infrastructure support
AWS Support is a one-on-one, fast-response support channel that is staffed 24x7x365 with experienced and technical support engineers. The service helps customers of all sizes and technical abilities to successfully utilize the products and features provided by Amazon Web Services.