# Welcome

Plumbing Copilot is an intelligent Revit plugin that automates the routing of plumbing systems. It uses advanced pathfinding algorithms to generate multiple clash-free pipe layouts based on your rules — saving hours of manual drafting time.

> **Plumbing Copilot 1.0 is live.** Start automating your plumbing design workflows inside Autodesk Revit today.

***

## What Plumbing Copilot Does

Plumbing Copilot sits inside your Revit environment as a native plugin. You define your routing rules — slope, clearances, pipe types, connection behavior — and the algorithm generates optimized, clash-free pipe routes in seconds.

No file exports. No external applications. Everything happens inside Revit using your existing families, system types, and project standards.

### Key Capabilities

* **Automated Pipe Routing** — Generate complete pipe routes between any two plumbing elements with a single command. The algorithm handles all the complexity of finding a valid path through your model.
* **Multiple Route Options** — Plumbing Copilot doesn't just give you one answer. It generates several valid routing alternatives so you can choose the one that best fits your design intent.
* **Rule-Based Pathfinding** — Define precise parameters for slope, minimum pipe lengths, clearances, and elbow styles. Every generated route strictly adheres to your rules.
* **Dynamic Obstacle Avoidance** — Select specific Revit categories (structural framing, ductwork, cable trays, equipment) as obstacles. The algorithm automatically routes around them while maintaining your clearance requirements.
* **Native Revit Elements** — Generated routes are standard Revit pipes, fittings, Wyes, Tees, and P-Traps from your loaded family library. Edit them with any Revit tool after placement.
* **Data-Driven Route Selection** — Compare routes side-by-side using metrics: total length, number of fittings, 90-degree elbows, 45-degree elbows, segments, and potential clashes. Sort by shortest length or fewest fittings.
* **Routing Elements** — Place 3D volumes (wall boxes, floor boxes, ceiling voids, plumbing chases) that define where pipes are allowed to travel. Routing elements are the foundation of every route — they tell the algorithm which spaces in your building are available for piping.
* **Reusable Configurations** — Save named routing configurations with all your preferred settings. Use them across projects or let Plumbing Copilot automatically match configurations to elements based on launch conditions.

***

## Supported Revit Versions

Plumbing Copilot integrates directly with **Autodesk Revit 2022 through 2026**. It runs natively as a Revit plugin — no additional software or external tools required.

***

## What You'll Learn

This documentation covers everything you need to get productive with Plumbing Copilot:

| Section                                                                                                   | What It Covers                                                        |
| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| [Getting Started](https://pipeit.gitbook.io/plumbing-copilot-v1/getting-started/installation)             | Installation, account setup, and your first automated route           |
| [User Interface](https://pipeit.gitbook.io/plumbing-copilot-v1/user-interface/ribbon-tab)                 | Every panel, button, and setting in the Plumbing Copilot interface    |
| [Routing Workflow](https://pipeit.gitbook.io/plumbing-copilot-v1/routing-workflow/configure-routing-rule) | Step-by-step guide through the complete routing process               |
| [Routing Elements](https://pipeit.gitbook.io/plumbing-copilot-v1/routing-elements/overview)               | How to use constraint volumes to guide pipe paths                     |
| [Design Features](https://pipeit.gitbook.io/plumbing-copilot-v1/design-features/connection-types)         | Deep dives into connection types, slope, clearance, P-Traps, and more |
| [Troubleshooting](https://pipeit.gitbook.io/plumbing-copilot-v1/troubleshooting/common-issues)            | Common issues, error reporting, and how to get support                |

***

## Quick Links

* **New to Plumbing Copilot?** Start with the [Quick Start Guide](https://pipeit.gitbook.io/plumbing-copilot-v1/getting-started/quick-start) to generate your first route in under 5 minutes.
* **Need help with a specific setting?** Go to the [Routing Preferences](https://pipeit.gitbook.io/plumbing-copilot-v1/user-interface/configurations) reference.
* **Something not working?** Check [Troubleshooting](https://pipeit.gitbook.io/plumbing-copilot-v1/troubleshooting/common-issues) or [Contact Support](https://pipeit.gitbook.io/plumbing-copilot-v1/troubleshooting/contact-support).

***

## Get in Touch

* **Support:** <support@pipeit.co>
* **Website:** [pipeit.co](https://pipeit.co)
* **Free Trial:** [Start your 30-day trial](https://pipeit.co/lms/user/register) — no credit card required
* **Enterprise:** [Request a demo](https://pipeit.co/contact?subject=demo)