An agent framework that treats Qwen models as first-class citizens
A Python framework for building LLM agents around Qwen models, shipping with browser assistants, sandboxed code execution, and enough pre-built components to avoid starting from scratch.

What it does
Qwen-Agent is a Python framework for assembling LLM applications on top of Qwen models. It offers atomic components—LLM wrappers with function calling, tool definitions, and agent classes—alongside higher-level building blocks like a file-reading Assistant. The project also powers the backend of Qwen Chat and ships with example applications including a browser assistant and code interpreter.
The interesting bit
Rather than pretending all LLMs are interchangeable, the framework tailors behavior to Qwen model quirks—offering specific vLLM parameter guidance for QwQ and Qwen3-Coder and adjusting function-call templates for the Qwen2.5 series. It also bundles a Docker-based sandbox for its code interpreter, while a Gradio 5 GUI layer lets you wrap agents in a web interface with minimal boilerplate.
Key highlights
- Built-in
Assistantagent reads files, calls tools, and manages multi-turn conversations out of the box - Supports MCP servers, RAG, and function calling with model-specific prompt templates
- Code interpreter executes inside Docker containers for isolation
- GUI layer runs on Gradio 5 and requires Python 3.10 or higher
- Ships with the DeepPlanning evaluation benchmark and cookbooks for Qwen3, Qwen3-VL, and Qwen3-Coder
Caveats
- The Python executor used in some math demos is explicitly not sandboxed and is labeled for local testing only, not production
- Several features assume access to Alibaba’s DashScope or a self-hosted Qwen model service; other LLM families are not the focus
Verdict A solid starting point if you are already running Qwen models and need a structured way to add tools, memory, or browser automation. If you want a model-agnostic agent framework, look elsewhere.
Frequently asked
- What is QwenLM/Qwen-Agent?
- A Python framework for building LLM agents around Qwen models, shipping with browser assistants, sandboxed code execution, and enough pre-built components to avoid starting from scratch.
- Is Qwen-Agent open source?
- Yes — QwenLM/Qwen-Agent is open source, released under the Apache-2.0 license.
- What language is Qwen-Agent written in?
- QwenLM/Qwen-Agent is primarily written in Python.
- How popular is Qwen-Agent?
- QwenLM/Qwen-Agent has 16.8k stars on GitHub and is currently holding steady.
- Where can I find Qwen-Agent?
- QwenLM/Qwen-Agent is on GitHub at https://github.com/QwenLM/Qwen-Agent.