# Tilelang Npuir Overview

> TileLang npuir 分支总体架构与编译链路指南。用户提及 npuir 分支结构、target=npuir、编译流程、lower/codegen 链路、Developer/Expert 模式、tladapter、tilelangir、bishengir-compile、环境变量时必须使用本技能。

- Skill: `tile-ai/tilelang-npuir-overview` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add tile-ai/tilelang-npuir-overview`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tile-ai/tilelang-npuir-overview/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tile-ai (https://skillmd.com/u/tile-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tile-ai/tilelang-npuir-overview

---


# TileLang NPUIR Overview

## What this skill provides

- npuir branch architecture map
- compilation pipeline from Python DSL to NPUIR codegen
- mode selection guidance for Developer and Expert
- module role mapping for tilelangir and tladapter

## Mandatory routing rule

Before answering, follow AGENTS.md section "Docs Auto Routing Rules (Mandatory)".

## Architecture map

- Frontend DSL: tilelang/language
- JIT entry: tilelang/jit/jit_npu.py
- Lowering entry: tilelang/engine/lower.py
- Adapter layer: tilelang/tladapter
- MLIR dialect and passes: tilelangir
- Backend codegen (Expert mode): src/target/codegen_npuir_api.cc and src/target/codegen_npuir_api.h
- Backend codegen (Developer mode): src/target/codegen_npuir_dev.cc and src/target/codegen_npuir_dev.h
- Deprecated backend file: src/target/codegen_npuir.cc

## Mode selection

- Developer mode: concise implementation, compiler-managed behavior
- Expert mode: explicit Scope control and fine-grained memory/sync

Common mode switch:
- os.environ["TILELANG_ASCEND_MODE"] = "Developer"

## References to read on demand

- references/arch.md
- references/compile-pipeline.md
- references/modes.md
- references/env-setup.md

## Official docs to consult

- docs/快速入门.md
- docs/开发指南.md
- docs/developer/EnvironmentVariables.md
- docs/developer/npu runtime.md

## Related skills

- tilelang-vector-skill
- tilelang-cube-skill
- tilelang-mixcv-skill
- tilelang-mlir-skill