# How to Build the Egonex-AI Understand Anything Project from Source

> Learn to build the Egonex-AI Understand Anything project from source. Follow our guide to install Nodejs pnpm clone the repo and build core & dashboard packages.

- Repository: [Egonex/Understand-Anything](https://github.com/Egonex-AI/Understand-Anything)
- Tags: how-to-guide
- Published: 2026-06-26

---

**Building the Egonex-AI Understand Anything project requires Node.js ≥ 22 and pnpm ≥ 10, followed by cloning the repository, installing workspace dependencies with `pnpm install`, and building the core and dashboard packages using pnpm filter commands.**

The Egonex-AI Understand-Anything repository is a **pnpm monorepo** that houses an AI-driven code analysis engine and a React-based knowledge graph dashboard. To build the Egonex-AI Understand Anything project from source, you must compile TypeScript sources across the workspace packages defined in [`pnpm-workspace.yaml`](https://github.com/Egonex-AI/Understand-Anything/blob/main/pnpm-workspace.yaml), which installs Web-Tree-Sitter WASM binaries and bundles the dashboard with Vite.

## Prerequisites

Before building, ensure your environment meets the following requirements:

- **Node.js ≥ 22** – The runtime required for the build scripts and package management.
- **pnpm ≥ 10** – The package manager pinned to version 10.6.2 in the repository lockfile.

Install pnpm globally if you haven't already:

```bash
npm install -g pnpm@10

```

## Clone and Install Dependencies

Clone the repository and install all workspace dependencies. This command resolves the monorepo graph defined in the root [`package.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/package.json) and installs packages for both the core engine and the dashboard.

```bash
git clone https://github.com/Egonex-AI/Understand-Anything.git
cd Understand-Anything
pnpm install

```

The `pnpm install` command also triggers the `prepare` script, which handles initial setup and pulls the required Web-Tree-Sitter WASM binaries for the Tree-sitter parsers used in code analysis.

## Build the Core Analysis Engine

The `@understand-anything/core` package contains the shared analysis engine with Tree-sitter parsers and LLM-driven graph building logic. Compile it using the pnpm filter command:

```bash
pnpm --filter @understand-anything/core build

```

This command runs `tsc` as defined in [`understand-anything-plugin/packages/core/package.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/understand-anything-plugin/packages/core/package.json), emitting plain JavaScript to the `dist/` directory. The core package exports modules for schema definitions, types, and parsing code into a knowledge graph structure.

## Build the React Dashboard

The `@understand-anything/dashboard` package provides the React + TypeScript UI that visualizes the knowledge graph. Build it with:

```bash
pnpm --filter @understand-anything/dashboard build

```

This executes Vite as configured in [`understand-anything-plugin/packages/dashboard/package.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/understand-anything-plugin/packages/dashboard/package.json), producing a production-ready bundle in the dashboard's `dist/` folder. The dashboard dependencies include React 19, Graphology for graph manipulation, and Tailwind for styling.

### One-Command Build

To execute the full build sequence in one line:

```bash
git clone https://github.com/Egonex-AI/Understand-Anything.git && cd Understand-Anything && pnpm install && pnpm --filter @understand-anything/core build && pnpm --filter @understand-anything/dashboard build

```

## Verify with Tests

Validate the compiled packages by running the Vitest test suites:

```bash

# Test the core engine

pnpm --filter @understand-anything/core test

# Test the dashboard UI components

pnpm --filter @understand-anything/dashboard test

```

All tests should pass with green checkmarks before you deploy or develop against the built packages. You can also verify the build by opening the compiled [`dist/index.html`](https://github.com/Egonex-AI/Understand-Anything/blob/main/dist/index.html) from the dashboard package or by running the plugin in a supported AI-coding platform.

## Run the Development Server

To run the dashboard in development mode with hot reload:

```bash
pnpm dev:dashboard

```

This command launches Vite’s development server as specified in the root [`package.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/package.json), typically on `http://localhost:5173`, allowing you to interact with the knowledge graph UI while making changes to the source in `understand-anything-plugin/packages/dashboard/`.

## Summary

- **Egonex-AI Understand Anything** is a pnpm monorepo requiring Node.js ≥ 22 and pnpm ≥ 10.
- Install dependencies with `pnpm install` from the repository root to trigger the `prepare` script and download Web-Tree-Sitter WASM binaries.
- Build the core package using `pnpm --filter @understand-anything/core build`, which compiles the Tree-sitter-based analysis engine.
- Build the dashboard using `pnpm --filter @understand-anything/dashboard build` to create the Vite-bundled React application.
- Run tests with `pnpm --filter <package-name> test` to verify functionality before deployment.
- Use `pnpm dev:dashboard` to start a local development server for interactive development.

## Frequently Asked Questions

### What versions of Node.js and pnpm are required to build the project?

The repository requires **Node.js ≥ 22** and **pnpm ≥ 10** (specifically pinned to version 10.6.2 in the lockfile). These versions ensure compatibility with the workspace scripts and the Web-Tree-Sitter WASM dependencies used by the core analysis engine.

### Can I build just the core package without the dashboard?

Yes. Run the filtered build command `pnpm --filter @understand-anything/core build` to execute the TypeScript compiler only for the core analysis engine defined in [`understand-anything-plugin/packages/core/package.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/understand-anything-plugin/packages/core/package.json), skipping the dashboard compilation entirely.

### How do I start the dashboard in development mode?

Execute `pnpm dev:dashboard` from the repository root. This script, defined in the root [`package.json`](https://github.com/Egonex-AI/Understand-Anything/blob/main/package.json), starts the Vite development server for the `@understand-anything/dashboard` package with hot module replacement enabled, allowing you to view changes to the React UI in real-time.

### Where are the compiled build artifacts located?

The core package emits compiled JavaScript to `understand-anything-plugin/packages/core/dist/`, while the dashboard produces its production bundle in `understand-anything-plugin/packages/dashboard/dist/`. These directories contain the final artifacts ready for deployment or integration into AI-coding platforms.