# Getting Started

> Status: Active
> Audience: First-time Niamoto users.
> Purpose: Install, open a project, ship a first portal.

## Choose a path

- Start with [installation.md](installation.md). Pick the desktop app or the
  Python CLI.
- Follow [first-project.md](first-project.md) if you want the desktop path from
  project creation to publish.
- Read [concepts.md](concepts.md) if you want the pipeline model before you
  edit config files.

## In this section

- [installation.md](installation.md)
- [first-project.md](first-project.md)
- [quickstart.md](quickstart.md)
- [concepts.md](concepts.md)

## If you use the desktop app

- Install the desktop build.
- Follow [first-project.md](first-project.md).
- Continue with [../02-user-guide/README.md](../02-user-guide/README.md).

## If you use the CLI

- Install `niamoto`.
- Read [quickstart.md](quickstart.md).
- Keep [../03-cli-automation/README.md](../03-cli-automation/README.md) open for
  the command map.

## Related

- [../02-user-guide/README.md](../02-user-guide/README.md) for the desktop
  workflow after setup.
- [../04-plugin-development/README.md](../04-plugin-development/README.md) for
  custom transformers, widgets, loaders, exporters, and deployers.
- [../09-troubleshooting/README.md](../09-troubleshooting/README.md) for common
  issues.

```{toctree}
:hidden:

installation
first-project
concepts
quickstart
```