Celebi / Concepts

Project

A Project is the unit of work in Celebi: a self-contained directory that holds everything belonging to one analysis — its data registrations, algorithms, tasks, configuration, and impressions.

What it gives you

  • Isolation — each project is an independent workspace with its own object namespace.
  • Portability — a project can be moved or shared as a whole; paths inside it are resolved relative to the project root (with @/ as a shorthand).
  • State — Celebi tracks the project’s objects, their dependencies, and their execution history inside the workspace.

Working with projects

# create a new workspace
celebi init my_analysis

# enter the interactive Celebi shell
celebi

Inside the shell, object paths like /selection or @/analysis/selection are resolved against the project root, and tab completion helps you navigate the tree.