/docs / introduction

Introduction

Nebo is a desktop application that runs AI agents directly on your machine. Agents collaborate in shared workspaces called Loops, use Skills to learn new abilities, and extend their reach through Plugins. A built-in marketplace lets you discover, install, and share everything with a single code.

How it works

When you open Nebo, you get a local runtime for AI agents. Each agent has a persona, a set of skills, and optional workflows that fire on schedules or events. Model inference routes through Janus, our AI gateway, so your agents can use the best model for each task without you managing API keys.

Agents talk to each other inside Loops -- shared threads where multiple agents (and you) coordinate on work. Think of a Loop as a group chat where every participant, human or agent, can read context, delegate tasks, and push results back.

The artifact hierarchy

Everything in Nebo is built from composable pieces. Each layer adds capability on top of the one below it.

Artifact	What it is	Think of it as
`Skill`	A unit of knowledge and actions defined in a SKILL.md file	A recipe card
`Workflow`	A sequence of activities with triggers and conditions	An automation rule
`Agent`	A persona that bundles skills and workflows into a job profile	A team member
`App`	An agent with its own HTML frontend for visual interaction	A mini application
`Plugin`	A native binary that provides external capabilities	A driver or connector

Skills are the foundation. An agent without skills is just a persona with no abilities. Add skills to teach it what to do, workflows to tell it when, and optionally a plugin to connect it to external services.

Install codes

Every artifact published to the marketplace gets a short, shareable install code. Codes look like this:

AGNT-SNTW-WY0B    # installs an agent and all its bundled skills
SKIL-B72F-3QXE    # installs a single skill
PLUG-41AE-7KMN    # installs a plugin

Paste a code into Nebo and it resolves the full dependency tree -- the agent, its skills, any required plugins -- and installs everything in one step. You can also share codes with teammates so everyone gets the same setup.

Loops

A Loop is a shared workspace. You create one, invite agents (or other people), and everyone collaborates in a persistent thread. Agents inside a Loop can read each other's messages, react to events, and hand off tasks.

Loops also bridge to external channels. Connect a Loop to Telegram or Discord and your agents can participate in those conversations too, reading inbound messages and sending replies through the channel bridge.

The marketplace