# Prerequisites and Dependencies for Running Terax AI: Complete Setup Guide

> Learn the essential prerequisites and dependencies for running Terax AI. Install Rust Nodejs pnpm and Tauri system libraries for a smooth setup.

- Repository: [Crynta/terax-ai](https://github.com/crynta/terax-ai)
- Tags: how-to-guide
- Published: 2026-07-06

---

**To run Terax AI locally, you need Rust (stable), Node.js 20+, pnpm, and platform-specific Tauri system libraries installed before cloning the repository.**

Terax AI is a native, terminal-first development workspace built with Tauri 2, Rust, React 19, and TypeScript. Before you can build or run the application from the crynta/terax-ai repository, you must install several system-level tools and package managers that support the entire stack. These prerequisites for running Terax AI cover everything from the Rust compiler to the Node ecosystem and platform-specific Tauri requirements.

## Core Prerequisites for Terax AI

### Language Runtimes and Package Managers

The build pipeline relies on three fundamental tools that must be present on your system:

- **Rust (stable)** – Install via [rustup.rs](https://rustup.rs) to get the compiler and Cargo, which are required to build the Tauri backend.
- **Node.js 20+** – Required for the React front-end and Vite tooling.
- **pnpm** – The preferred package manager for installing Node dependencies; install with `npm i -g pnpm` or see [pnpm.io](https://pnpm.io).

### Tauri System Dependencies

Because Terax AI uses Tauri 2, you must install platform-specific libraries and toolchains before running the application. The exact commands vary by operating system:

- **macOS**: Install GTK and librsvg using Homebrew: `brew install gtk+3 librsvg`
- **Linux**: Follow the official Tauri prerequisites for your specific distribution, which typically include C toolchains, GTK development headers, and WebKit libraries.
- **Windows**: Install MSYS2 and the required MinGW-w64 toolchains as documented in the Tauri setup guide.

See the official Tauri documentation at [tauri.app/start/prerequisites/](https://tauri.app/start/prerequisites/) for detailed instructions for your platform.

## Optional Dependencies for AI Features

While not required for the core workspace functionality, certain dependencies enable the AI side-panel features:

- **AI Provider Keys** – API keys for OpenAI, Anthropic, or other providers are only required if you intend to use cloud-based AI features. These keys are stored securely in the OS keychain.
- **Local Inference Servers** – To run models locally without cloud dependencies, you can install LM Studio, Ollama, or MLX. These are optional runtime components that integrate with the AI subsystem described in [`TERAX.md`](https://github.com/crynta/terax-ai/blob/main/TERAX.md).

## Installation Steps

Once you have installed the prerequisites above, follow these commands to set up and run the development version:

1. Clone the repository and navigate to the directory:

```bash
git clone https://github.com/crynta/terax-ai.git
cd terax-ai

```

2. Install Node dependencies using pnpm:

```bash
pnpm install

```

3. Launch the development version:

```bash
pnpm tauri dev

```

4. Build a production bundle (optional):

```bash
pnpm tauri build

```

These steps are documented in the repository's [`README.md`](https://github.com/crynta/terax-ai/blob/main/README.md) at lines 226-230.

## Key Configuration Files

Understanding the dependency structure helps when troubleshooting build issues:

- **[`package.json`](https://github.com/crynta/terax-ai/blob/main/package.json)** – Declares Node.js and React dependencies including React 19, Vite, Tailwind CSS, shadcn/ui, and Zustand for state management.
- **[`src-tauri/Cargo.toml`](https://github.com/crynta/terax-ai/blob/main/src-tauri/Cargo.toml)** – The Rust crate manifest that lists Tauri, portable-pty, and other backend crates required for the native terminal functionality.
- **[`src/main.tsx`](https://github.com/crynta/terax-ai/blob/main/src/main.tsx)** – The React front-end entry point that bootstraps the UI and initializes the AI side-panel.
- **[`TERAX.md`](https://github.com/crynta/terax-ai/blob/main/TERAX.md)** – Contains the living architecture document detailing the IPC model, AI subsystem, and security model.

## Summary

- **Rust (stable)**, **Node.js 20+**, and **pnpm** are mandatory prerequisites for building Terax AI from source.
- **Platform-specific Tauri libraries** (GTK on macOS/Linux, MSYS2 on Windows) must be installed before running the application.
- **AI provider keys** and **local inference servers** are optional dependencies only required for AI side-panel functionality.
- The repository uses standard `pnpm` workflows: `pnpm install` followed by `pnpm tauri dev` launches the development environment.

## Frequently Asked Questions

### Do I need a GPU to run Terax AI?

No. Terax AI itself does not require a GPU for the core terminal and workspace functionality. However, if you plan to run local inference servers like LM Studio or Ollama for the AI features, those specific workloads may benefit from GPU acceleration depending on the model size.

### Can I use npm or yarn instead of pnpm?

While the repository documentation specifies pnpm as the preferred package manager, you could theoretically use npm or yarn. However, the lock files and scripts in [`package.json`](https://github.com/crynta/terax-ai/blob/main/package.json) are optimized for pnpm, and using alternative package managers may lead to dependency resolution issues or longer install times.

### Are the AI features mandatory to use the application?

No. The AI side-panel and cloud provider integrations are completely optional. You can use Terax AI as a terminal-first development workspace without configuring any API keys or local inference servers. The core functionality, including the terminal emulator and file management, works independently of the AI subsystem.

### What Rust version is specifically required?

The repository requires the **stable** Rust toolchain, which you can install via rustup. While the [`src-tauri/Cargo.toml`](https://github.com/crynta/terax-ai/blob/main/src-tauri/Cargo.toml) does not specify an exact version constraint beyond what Tauri 2 requires, keeping your Rust installation updated via `rustup update` ensures compatibility with the latest Tauri security patches and features.