Installing

Requirements

  • Python 3.10+

Install from PyPI

pip install nebo

Or with uv:

uv add nebo

Optional extras

To use nebo deploy (push the daemon to a Hugging Face Space), also install huggingface_hub:

pip install 'nebo[deploy]'

Agent skills

While nebo allows humans to have a very flexible viewing experience, one of nebo’s primary goals is to give coding agents the full capacity to build.

Nebo provides 2 agent skills and can be installed automatically with the nebo CLI.

  • instrumentation - used when agents are building nebo-integrated Python code, so they understand how to log and what to log.

  • runs-qa - used when agents are asked about nebo runs and asked to generate derived metrics on the active nebo service.

Claude Code

Install all of the skills onto Claude Code.

nebo skill install --platform claude-code --skill all

Other platforms

Install all of the skills the cross-platform way.

nebo skill install --platform agents-md --skill all

Quick Start

Run a pipeline (writes events to ./.nebo/ by default, no daemon needed):

python my_pipeline.py

Or start the daemon for live observability with a web UI:

nebo serve

Then visit http://localhost:7861 to see the UI.

Install from Source

Installing from source requires uv and Node.js.

git clone https://github.com/graphbookai/nebo.git
cd nebo
uv sync --all-groups

To build the web UI from source:

cd ui
npm ci
npm run build
cp -r dist/* ../nebo/server/static/