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/