---
title: "Projects"
description: "Make a project in Tato Studio, start one from a sample, open or import one, duplicate it, and share it with someone else as a folder or a .zip."
type: "docs-page"
url: "https://tatolab.com/docs/studio/projects"
site: "Tatolab"
section: "Tato Studio"
---

# Projects

> Make a project in Tato Studio, start one from a sample, open or import one, duplicate it, and share it with someone else as a folder or a .zip.

A project is one folder: its streams, its nodes' code, its assets and the modules it uses. Studio opens one project per window, and plays it as a whole.

## Make one

Choose **New project** (⌘N) in the Projects window, or **File › New project…**. Give it a name and Studio makes its folder in `Documents/Tato Studio/`, or in another location you pick, and opens it. It starts with one stream, which shows a test pattern: colour bars with a potato bouncing around them. There's no camera, Python or anything else to set up first; the runtime brings its own Python and makes the project's environment the first time it opens.

## Start from a sample

Every [example](https://tatolab.com/docs/examples) is also a sample project. Open **File › Marketplace…**, find the sample, and press **Clone sample**: Studio downloads it, checks it against its SHA-256, and makes it a new project of your own. The project you had open isn't changed.

## Open and import

- **File › Open project…** (⌘O), or **Import project folder…** in the Projects window, opens a project folder that's already on disk: one you made from the command line, cloned from git, or copied from another machine.
- **Import project .zip…** makes a new project from a project's `.zip`, in a new folder, under the name it was saved with. It gets a project identity of its own, so the same `.zip` imported twice makes two separate projects.

## Duplicate, rename, describe

Each card in the Projects window has a **⋯** menu:

- **Details** opens the project's name, its description and its cover image. With no cover, the card shows a plain one in a colour picked from the name.
- **Rename…** renames the project; its folder stays where it is.
- **Duplicate** copies the project, with its whole history, into a new folder beside it, as a separate project.
- **Delete…** stops its streams and moves its folder to the Trash, where you can put it back.

A rename, a new description or a new cover is an edit like any other: **Edit › Undo** takes it back.

## Share a project

A project is its folder, so sharing one is sharing that folder:

- **As a `.zip`.** Compress the project folder and send it. The other person chooses **Import project .zip…** and gets a project of their own. The import leaves out the project's `.tatolab/` folder, which holds this machine's log and history, and its Python environment, which the runtime makes again for their machine.
- **With git.** A project is plain files: the graph documents in `streams/`, your nodes' Python, `pyproject.toml`, the assets and their sidecar files. Commit it, and anyone who clones it opens it with **File › Open project…**.
- **As a module.** A project can be imported into another one, its nodes and streams with it. See [Marketplace and modules](https://tatolab.com/docs/studio/marketplace#add-a-module-from-a-folder-or-a-zip).

The other person needs Tato and the hardware the project uses: a camera, a GPU with what its nodes need, and so on. Modules from the Marketplace say which machines they run on.

## What's in the folder

```txt
my-stream/
├── tatolab-project.json      the project: its name, its identity and its modules
├── streams/
│   └── main.graph.json       each stream: its nodes and the wires between them
├── nodes/                    the nodes you write
├── imports/                  the modules you added, copied in
├── pyproject.toml            the Python packages your nodes use
└── .tatolab/                 this machine's log and the project's history
```

Studio writes all of it for you. If you'd rather work with the files directly, [Streams and graphs](https://tatolab.com/docs/build/graphs) describes the graph document, and the [CLI](https://tatolab.com/docs/reference/cli) works on the same folder.

## One project, many places

A project open in Studio is open in the runtime, so the `tatolab` command and an agent see and change the same project while you work. When you quit Studio, the runtime it started stops with it, and the project opens again, playing or stopped as you left it, the next time a runtime starts. On a machine where the runtime runs as a service, it keeps playing without Studio. See [Keep it running](https://tatolab.com/docs/tutorial/keep-running).
