# Set up the TEN Framework development environment (/en/ai/ten-agent/get-started/set-up-environment)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

This guide explains how to set up your development environment for the TEN Framework. The TEN Framework supports Windows, Linux, and Mac, with Linux or Mac recommended.

## Linux setup [#linux-setup]

For Ubuntu, install the following packages:

* `gcc` - C/C++ compiler supported by TEN
* `clang` - Alternative C/C++ compiler
* `clang-format` - Code formatting tool used during runtime
* `clang-tidy` - Static code analyzer
* `cmake` - Build system (version 3.13+)
* `Python3` - Required for Python binding
* `pytest` - Used for integration testing

## Mac setup [#mac-setup]

Required components:

* XCode
* CocoaPods
* Personal Account

Install dependencies:

```bash
brew install llvm googletest doxygen ninja clang-format
brew install include-what-you-use
```

If the brew-installed cmake is outdated, install from the official website and create a symbolic link:

```bash
ln -s /Applications/CMake.app/Contents/bin/cmake /usr/local/bin/cmake
```

If cmake can't find clang-tidy, use:

```bash
ln -sf /usr/local/opt/llvm/bin/clang-tidy /usr/local/bin/clang-tidy
```

For language bindings, install:

```bash
brew install python golang
```

## Windows setup [#windows-setup]

Install these components:

* Visual Studio Community (up to 2022)
  * Select clang-related tools
  * Add clang binary path to the PATH environment variable
* cmake
* python

<CalloutContainer type="info">
  <CalloutDescription>
    When installing cmake and python, avoid paths containing spaces.
  </CalloutDescription>
</CalloutContainer>

## Build system setup [#build-system-setup]

### ten\_gn [#ten_gn]

TEN uses `ten_gn` as its build system (based on Google GN). The source code is in the `core/ten_gn` directory of the TEN Framework repository. Add this directory to your system PATH.

### Docker containers [#docker-containers]

For a pre-configured build environment, we provide Docker files.

#### Ubuntu 22.04 [#ubuntu-2204]

Navigate to `tools/docker_for_building/ubuntu/22.04` and run:

```bash
docker-compose up -d
docker-compose run ten-building-ubuntu-2204
```