nebi

Nebi

Multi-user environment management for Pixi

⚠️ Alpha Software: Nebi is currently in alpha. APIs, UI, CLI and available features may change without notice. Not recommended for production use.

What is Nebi?

If your Python projects need compiled libraries like GDAL or CUDA, you know pip install often isn't enough. Pixi solves that by managing both Python packages and system libraries in one lockfile.

Nebi builds on Pixi to add what teams need: version history, rollback, sharing environments through registries, and access control over who can change production dependencies.

Key features:

• Install system libraries alongside Python packages (via Pixi)
• Push, pull, and diff versioned environments across machines
• Share environments through OCI registries (Quay.io, GHCR, etc.)
• Roll back when a dependency update breaks your workflow
• Control who can modify shared environments with role-based access
• Activate any workspace by name from any directory

Quick Start

Install

Pixi is a required Nebi dependency. If not already installed, install pixi as described in the pixi docs. Then use pixi to install Nebi:

# Installs CLI + Desktop App (recommended)
pixi global install nebi

If you only need the CLI or the desktop app individually:

# CLI only
pixi global install nebi-cli

# Desktop app only
pixi global install nebi-desktop

Alternative installation methods are also available.

CLI Quick Start

Set up

Start a local Nebi server (set your own admin credentials):

export ADMIN_USERNAME=admin
export ADMIN_PASSWORD=your-password
nebi serve

This starts the Nebi server at http://localhost:8460.

In a new terminal, connect the CLI to the server:

nebi login http://localhost:8460

Track and push your environment

Initialize nebi in your project:

cd my-project
nebi init

Push your environment to the server:

nebi push myworkspace

Or tag a specific version:

nebi push myworkspace:v1.0

Once pushed, your workspace appears on the server dashboard:

Pull on another machine

Pull an environment on another machine:

nebi pull myworkspace:v1.0

Verify what version you're running with nebi status:

nebi status

Workspace: myworkspace
Path:      /Users/you/my-project
Server:    http://localhost:8460
Origin:    myworkspace:v1.0 (pull)

Documentation

• CLI Guide - Full CLI usage and workflows
• CLI Reference - All commands and flags
• Server Setup - Configuration and environment variables
• Architecture - How the CLI, server, and OCI registries fit together

API documentation is available at /docs on any running Nebi server (e.g. http://localhost:8460/docs).

Alternative Installation Methods

Shell Script

Linux / macOS:

curl -fsSL https://nebi.nebari.dev/install.sh | sh

Windows (PowerShell):

irm https://nebi.nebari.dev/install.ps1 | iex

See install.sh --help for advanced options (--version, --install-dir, --desktop).

GitHub Releases

Download pre-built binaries from the releases page.

Build from Source

go install github.com/nebari-dev/nebi/cmd/nebi@latest

Requires Go 1.24+.

Contributing

See CONTRIBUTING.md for development setup, build instructions, and project structure.