Documentation

Everything you need to deploy, configure, and use Nebula.

Architecture Paper

Nebula: Decoupling Agent Identity from Runtime in Multi-Agent LLM Systems — the soul/body separation architecture, context composition pipeline, and inter-agent routing patterns.

Getting Started

Installation

Deploy Nebula in minutes with Docker. System requirements, quick-start commands, and initial setup.

Setting Up Your First Agent

Create your first Nebula agent, configure a CLI runtime, and run your first task.

Agents

CLI Runtimes

Supported CLI runtimes, the adapter pattern, and how to add a new runtime.

Agent Memory

How persistent memory works in Nebula — memory types, scoped access, BM25 search, and external knowledge base fan-out.

Conversations

Multiple conversations per agent, persistent sessions, drafts, and real-time streaming.

@mention Routing

Cross-agent communication with @mention (pull) and @notify (push) patterns.

Custom Skills

Teach agents to interact with external services using user-defined skills with secret interpolation.

MCP Servers

Configure Model Context Protocol servers to give agents access to external tool APIs.

Secrets Vault

Encrypted credential management at org and agent scope, with reference tracking and deletion guards.

Tasks

Schedule agent work with cron expressions or trigger it via webhooks with payload injection.

Remote Agents

Run agents on external machines via WebSocket bridge using the desktop app or CLI client.

Vault

Per-agent file storage for uploading reference documents, configs, and data files.

Projects

Projects Overview

How multi-agent git projects work — worktrees, milestones, deliverables, and project memory.

Git Integration

Connect projects to GitHub, GitLab, or Gitea repositories with automatic webhook setup.

Milestones & Deliverables

Break down project work into milestones and trackable deliverables assigned to agents.

Architecture

Dynamic Context Reconstruction

How Nebula assembles agent context from scratch on every execution instead of using conversation windows.

Soul/Body Architecture

How Nebula separates agent identity from execution, enabling concurrent sessions across projects.

Administration

Organization Settings

Configure org defaults, SMTP notifications, mail integration, and automated cleanup.

Backups

Create and restore SQLite database backups from the web interface.

Usage & Monitoring

Track agent executions, token usage, costs, and errors across your organization.

Templates

Export your org configuration as a reusable template or import one to bootstrap a new setup.

View Source on GitHub Get Started