Run This Ai
EN DE

AReaL Tutorial: Train Your First AI Agent with Asynchronous Reinforcement Learning

A hands-on guide to training agents with AReaL: pull the runtime, point it at any agent app, and launch async RL training.

In this tutorial, we walk through training your first agent with AReaL β€” the large-scale asynchronous RL system from Tsinghua IIIS and Ant Group. If you can run Docker and a GPU, you can follow along.

πŸš€ Want to deploy AReaL yourself?

Docker configs, system requirements, and installation guides β€” all on one page.

View AReaL Tool Page β†’

Step 1: Pull the runtime

AReaL ships a Dockerfile with sglang and vllm variants. Build or pull the image, then mount a data directory:

docker build -t areal-runtime:dev-sglang .

Step 2: Point AReaL at your agent

The killer feature: AReaL works with black-box agent applications. You don't need to rewrite your agent runtime β€” just replace the base_url with AReaL's RL service. The project ships complete examples (math, coding, SWE, even an OpenClaw agent) that follow exactly this pattern.

AReaL async scaling vs vLLM

Step 3: Launch asynchronous training

Start with a ready-made config like examples/math/gsm8k_kpop.yaml. AReaL's fully asynchronous paradigm keeps generation, training, and weight updates running in parallel β€” watch the training curve climb:

AReaL 7B zero training curve

Review: strengths and trade-offs

StrengthsTrade-offs
Industry-leading throughputRequires GPU hardware for real training runs
Agent-agnostic by designSteeper learning curve than simple fine-tuning
Active community & docsOfficial Docker Hub image still maturing

For teams serious about reasoning and agentic models, AReaL is one of the most complete open-source RL stacks available today.

πŸš€ Ready to run AReaL?

Get the Docker setup, requirements, and deployment guide.

View AReaL Tool Page β†’
#tutorial #reinforcement-learning #agents