bytedance

trae-agent: LLM Agent for Software Engineering

Trae Agent is a Python CLI agent that uses configurable LLM providers to carry out general-purpose software engineering tasks. Its modular tools, interactive mode, and recorded trajectories suit developers and researchers who want to run or study agent workflows.

Stars
12.2k
Forks
1.4k
Stars, last 30 days
+59
Last commit
9 months ago
Contributors
49

Our take

Quietno commits in the last 90 days and no release in a year

Health score

42/100

How it is scored
Activity
19
Community
74
Issues
53
Pull requests
20

+59 stars in the last 30 days

Trae Agent offers a configurable and inspectable approach to LLM-assisted engineering, but its recent quiet period makes current maintenance worth checking before adoption.

Good fit if

  • You want a Python CLI for delegating multi-step software tasks to an LLM-based agent.
  • You need to inspect agent actions or experiment with a modular agent architecture.
  • Your environment supports Python 3.12 or newer and you can provide credentials for a supported model provider, or use Ollama.

Look elsewhere if

  • You require a project with recent commits or releases: the measured health reports no commits in the last 90 days and no release in the past year.
  • Your workflow needs a maintained integration that is not among the tools and providers documented by the project.
  • You need a turnkey service rather than a CLI that requires configuration and an LLM provider.
All health signals
Last commit2026-02-05 (9 months ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors49 (top contributor: 35% of commits)
Issues closed, last 90 days2
Pull requests merged, last 90 days0
Project age17 months

Checked on 2026-10-23 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

12,202

Forks

1,375

Change since Nov 14, 2026: +1 stars·0 forks

Overview

Trae Agent is a Python CLI agent built around configurable large language models for general-purpose software engineering tasks. It takes natural-language instructions and uses tools such as file editing and shell execution to work on code, aiming to handle multi-step development workflows rather than just answer questions.

The project is also framed as a research-friendly agent framework: its modular architecture and trajectory logs can help developers and researchers inspect, modify, and analyze agent behavior. It supports several hosted providers and Ollama, and can run tasks in Docker when configured.

Key Features

  • Run software tasks from natural-language instructions through the trae-cli command-line interface.
  • Configure providers and models including OpenAI, Anthropic, Google Gemini, OpenRouter, Doubao, Azure, and Ollama.
  • Use tools for file editing, bash execution, sequential thinking, and task completion.
  • Work interactively, iterating on development tasks in a conversational session.
  • Record agent steps, model interactions, and tool usage in trajectory files for debugging and analysis.
  • Configure agents, models, and tools with YAML, with environment variables also supported.
  • Run tasks in Docker containers using an image, Dockerfile, or existing container.

Use Cases

  • A developer can ask the CLI to fix a bug, add tests, or refactor a module, then review the resulting changes.
  • A researcher studying software agents can inspect recorded trajectories and modify the modular agent setup for experiments.
  • A team can compare supported LLM providers on development tasks by changing model configuration.
  • A developer can run a task in a Docker environment when they want its execution separated from their host setup.

What you need

Detected in the repository

  • Python >=3.12 (from pyproject.toml)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install UV, then clone the repository and install its dependencies:

git clone https://github.com/bytedance/trae-agent.git
cd trae-agent
uv sync --all-extras

Configure a model provider, then try trae-cli run "Create a hello world Python script". See the README for provider configuration, Docker usage, and additional options.

Alternatives

  • gpt-engineer: gpt-engineer focuses on generating and iterating on code from natural-language specifications, rather than general-purpose software engineering workflows.
  • gpt-pilot: GPT Pilot guides a developer through planning, coding, reviewing, and debugging applications step by step; it is no longer maintained.
  • SWE-agent: SWE-agent focuses on giving models tools to diagnose and attempt fixes for issues in real repositories, especially for research and configurable tasks.
  • mini-swe-agent: mini-swe-agent uses a compact agent loop with bash for repository tasks such as GitHub issues, rather than Trae Agent's broader modular workflow.
ProjectLanguageLicenseStarsStatus
trae-agentPythonMIT12.2kQuiet
gpt-engineerPythonMIT55.1kArchived
gpt-pilotPython–33.6kQuiet
SWE-agentPythonMIT20.5kMaintained
mini-swe-agentPythonMIT8.2kActive

Considerations

The project requires Python 3.12 or newer, UV for the documented setup, and access to a configured model provider; using hosted providers may also require API credentials. Docker is an optional execution mode, not a stated installation requirement. The measured health marks the project Quiet, with no commits in the last 90 days, no releases in a year, and only two issues closed in that period. It has 49 contributors and is not flagged as contributor-concentrated, so the quiet activity is not evidence that the project depends mostly on one person. The README describes the project as actively developed, but the measured activity indicates a pause that adopters should investigate. The project is MIT-licensed.

Found this useful?

Share it with someone who would like trae-agent.

Comparisons