NeboAI
NeboAI
Qallariy

Nebopaq Appkunata Ruway

IAykiman musuq atiykunata quy. Herramientakuna, canalkuna, gatewaykuna, UI panelkuna — yuyaykusqayki imapas, nativo binarioman compilasqa.

Llapanmanta qhawariy

Nebo ima kasqan

Neboqa sapallan escritorio IA yanapaqmi — sapa kuti puriq IA llamk'aq, digital kawsayniykita kamachiq. Nebomanta yuyaykuy smartphonemanta yuyaykusqayki hina: atiyniyuq plataforma, appkunanwan hatun tikrayta apamuq.

Sapallanqa, Neboqa atiyniyuq IA llamk'aqmi yuyaywan, horario kamachiywan, web maskhaywan, archivo kamachiywan, shellman yaykuywanpas. Ichaqa chiqap kichaqqa Appkunam. Smartphonepa atiynin app ecosistemanmanta hamusqan hina, Neboq atiyninpas ruwayninta yapaq appkunamantam hamun.

Appkuna ima kasqanku

Nebo Appkunaqa sapallanku, ñawpaqmanta compilasqa, ancha atiyniyuq unidadkunam. Sapa appmi Neboman musuq atiyta qun — calendario kamachiy, correo akllay, proyecto qatiy, wasi automatización, qullqi qhawariy — desarrollador yuyaykusqan imapas.

Appkunaqa ancha atiytam qunku ancha seguro kaqpi. Sapa appmi sandboxpi purin, ñawpaqmantaqa mana permisoyuq. Manifiestonpi willasqanta, usuario aprobasqantallam yaykuyta atin.

Interfazqa 100% rimanakuymi. Usuariokunaqa manam sapaq pantallakunawan utaq dashboardkunawan appkunata llamk'achinkuchu. Nebowanmi rimanku, Nebotaq appq herramientankunata llamk'achin imakunatapas ruwananpaq. "¿Paqarin calendariopi imataq kan?" — Nebo calendario appta waqyan. "Sarahwan 3pmpi tupanakuyta ruway" — Nebo calendario appta waqyan. Usuarioqa manapuni rimanakuymanta lluqsinchu.

Appkunaqa munaspa ajustes UIta quyta atinku — configuración panel, Neboq kikin navegador ventananpi kichakuq. Kaypim usuariokuna API llavekunata churanku, funcionkunata prendenku utaq wañuchinku, apptataq configuranku. Ajustes UIqa manifiestopi settings arraywan purichisqa (Neboqa formulariota kikillanmanta rikuchin), utaq appqa ui atiywan kikinpa llapan personalizasqa UInta quyta atin.

Appkunaqa Neboq kikin atiyninkunatam rantinku, yapankutaq. Neboqa básico plataforma herramientakunawanmi hamun (kaypi calendarioman yaykuy, pantalla foto, hukkunapas). Calendario appta instalaptiykiqa, kikin calendario herramientatam rantin, aswan hatuntaq kapun — kaypi + nube + huñuy + libre kayta qhaway.

Compilasqalla Politica

Neboqa sinchi compilasqalla binario politicatam kamachin. Llapan appkunam nativo compilasqa ejecutablekuna kananku.

EstadoSimikuna
AtisqaGo (yuyaychasqa), Rust, C/C++, Zig
Mana chaskisqaPython, Node.js, Ruby, Java, .NET, shell scriptkuna

Imarayku:

  • IA kikinta tikrakuyta harkay — Shellman yaykuyniyuq IA llamk'aqqa interpretasqa scriptpa ruwayninta purishaqtin tikrayta atinman. Compilasqa binariokunaqa firmasqa kaspa manañam tikrakunchu.
  • Firmaq ch'uya kaynin — Ed25519 firmakunaqa binariopa raw byteskunatam tapanku. Firmasqa binarioqa manam tikrakuyta atinchu firmata mana anulaspa.
  • Sandbox kamachiy — Binario formato validación (ELF/Mach-O/PE magic bytes) usqhay, confiakuna punku.

Usqhay Qallariy

SDKta instalay

Oficial SDKkunam llapan gRPC servidor wakichiyta, señal kamachiyta, protocolo chakaytapas ruwanku. Qamqa handler interfazkunatallam ruwanki.

Go (yuyaychasqa):

go get github.com/neboloop/nebo-sdk-go

Rust (ratullam hamunqa):

# Coming soon
[dependencies]
nebo-sdk = "0.1"

C/C++ (ratullam hamunqa):

# Coming soon — Add as a CMake subdirectory or copy headers from sdk/c/include/

App Directorio Estructura

Appkunaqa Nebo willakuy directorioykiq apps/ subdirectorionpim tiyanku:

~/Library/Application Support/Nebo/apps/   # macOS
~/.config/nebo/apps/                        # Linux
%AppData%\Nebo\apps\                        # Windows

apps/
  com.example.myapp/
    manifest.json       # Required: app metadata
    binary              # Required: executable (or named "app")
    signatures.json     # Required for NeboAI distribution, optional in dev
    TOOL.md             # Required: tool instructions for the agent
    data/               # Auto-created: app's sandboxed storage
    logs/               # Auto-created: stdout.log, stderr.log
    ui/                 # Optional: static UI assets (HTML/CSS/JS)

Pisi App Checklist

  1. manifest.jsonta kamay id, name, version, provideswan
  2. TOOL.mdta qillqay IA llamk'aq herramientaykita imayna llamk'achinanta willaspa
  3. SDKta instalay (go get github.com/neboloop/nebo-sdk-go)
  4. Atiyniykipaq handler interfazta ruway (ToolHandler, ChannelHandler, hukkunapas)
  5. Handlerta registray, app.Run()tataq waqyay
  6. Nativo binariota ruway (go build -o binary .)
  7. Binario + manifest.json + TOOL.mdta apps/<your-app-id>/ directoriopi churay
  8. Neboqa kikillanmanta tarin, qallarichintaq

Configuración

manifest.json

Sapa appmi manifest.jsonta necesitan:

{
    "id": "com.example.myapp",
    "name": "My App",
    "version": "1.0.0",
    "description": "What this app does",
    "runtime": "local",
    "protocol": "grpc",
    "provides": ["tool:my_tool"],
    "permissions": ["network:outbound"],
    "settings": [
        {
            "key": "api_key",
            "title": "API Key",
            "type": "password",
            "required": true,
            "description": "Your API key for the service",
            "secret": true
        }
    ]
}

Necesitakuq camponkuna:

CampoWillakuy
idKutiq-dominio riqsichiq (qhawarichinapaq, com.mycompany.myapp)
nameRuna ñawinchanan suti
versionSemver qillqa
providesYaqa huk atiy (uraypi qhaway)

Munaspa camponkuna:

CampoÑawpaqmantaWillakuy
runtime"local""local" utaq "remote"
protocol"grpc""grpc"llam atisqa
permissions[]Appqa imaman yaykuyta necesitan
description""UIpi rikuchisqa
settings[]Configurana ajustekuna (Ajustes UIpi rikuchisqa)
oauth[]OAuth proveedor necesitaykuna (uraypi OAuth partepi qhaway)

Atiykuna

Appniyki ima qusqanta willay:

AtiygRPC ServicioWillakuy
gatewayGatewayServiceLLM modelo pusay
tool:<name>ToolServiceIA llamk'aqpaq sutiyuq herramienta
channel:<name>ChannelServiceMensaje canal
commCommServiceIA llamk'aqkuna purapi rimanakuy
uiUIServiceHTTP proxywan personalizasqa UI
scheduleScheduleServicePersonalizasqa horario
visionToolServiceRikuy procesamiento
browserToolServiceNavegador automatización

Huk appqa achka atiykunatam quyta atin. Qhawarichinapaq, huk appqa herramientatapas UI paneltapas quyta atinman.

Permisokuna

Permisokunam appq imaman yaykuyta atisqanta kamachinku. Ñawpaqmantaqa mana — mana willasqa kaptinqa, appqa manam llamk'achiyta atinchu.

PrefijoQhawarichinakunaWillakuy
network:network:outbound, network:*Redman yaykuy
filesystem:filesystem:read, filesystem:writeArchivo sistemaman yaykuy
memory:memory:read, memory:writeIA llamk'aqpa yuyayninman yaykuy
session:session:readRimanakuy sesionkuna
tool:tool:shell, tool:fileHuk herramientakunata llamk'achiy
shell:shell:execShell kamachikuykunata purichiy
channel:channel:send, channel:*Canal ruwaykuna
comm:comm:send, comm:*IA llamk'aqkuna purapi rimanakuy
model:model:chatIA modeloman yaykuy
user:user:tokenMañakuykunapi usuario JWTta chaskiy
schedule:schedule:createCron llamk'ay kamachiy
database:database:queryBase de datosman yaykuy
storage:storage:read, storage:writeWiñay waqaychana
context:context:readIA llamk'aqpa contextonman yaykuy
subagent:subagent:spawnSub-agent ruwaykuna
lane:lane:enqueueLane ruwaykuna
notification:notification:sendPush willakuykuna
embedding:embedding:searchVector embeddingman yaykuy
skill:skill:invokeAtiyta waqyay
advisor:advisor:consultAdvisor sistemaman yaykuy
mcp:mcp:connectMCP servidorman yaykuy
voice:voice:recordKunka/audioman yaykuy
browser:browser:navigateNavegador automatización
oauth:oauth:google, oauth:*OAuth tokenman yaykuy
settings:settings:readAjustekunaman yaykuy
capability:capability:registerAtiy registro

Wildcard permisokunaqa atisqam: network:*qa mayqin network: permiso qhawaywanpas tupanmi.

Ajustekuna

Ajustekunaqa Nebo UIpi appq ajustes panelninpim rikhurin. Neboqa base de datospim waqaychan, tikrakuptinkutaq appniykiman Configure RPCwan kachan.

Ajustes esquemaykiqa NeboAI app store listapim kapun. Mana configurasqa necesitakuq ajustekunayuq appkunaqa UIpi "Needs Setup" insigniatam rikuchinku.

LayaWillakuy
textHuk siruyuq qillqa yaykuy
passwordPakasqa qillqa yaykuy
toggleBoolean prendey/wañuchiy switch
selectÑawpaqmanta churasqa akllanakunayuq dropdown
numberYupay yaykuy
urlValidaciónniyuq URL yaykuy
{
    "key": "region",
    "title": "Region",
    "type": "select",
    "required": true,
    "default": "us-east-1",
    "options": [
        {"label": "US East", "value": "us-east-1"},
        {"label": "EU West", "value": "eu-west-1"}
    ]
}

OAuth Necesitaykuna

Appkunaqa OAuth proveedor necesitaykunata willayta atinku. Neboq OAuth brokernin llapan purikuyta ruwan — appkunaqa Configure RPCwan kikillanmanta tokenkunata chaskinku.

{
    "oauth": [
        {
            "provider": "google",
            "scopes": ["https://www.googleapis.com/auth/calendar"]
        }
    ]
}
CampoWillakuy
providerOAuth proveedor: "google", "microsoft", "github"
scopesAppq necesitasqan OAuth scopekuna array

Usuario appta instalaptinqa, Neboqa necesitakuq OAuth scopekunata autorizananpaqmi tapun. Appqa Configure RPCwan musuqchasqa tokenkunata chaskin, OAuth purikuyta kikin mana ruwaspa.

Entorno Variablekuna

App procesoykiqa pichasqa entornotam chaskin. Llapan pakasqakunam hurqusqa. Kaykunata chaskinki:

VariableChanin
NEBO_APP_DIRAppq instalación directorion
NEBO_APP_SOCKKamana Unix socketman ñan
NEBO_APP_IDManifiestomanta App ID
NEBO_APP_NAMEManifiestomanta App suti
NEBO_APP_VERSIONManifiestomanta App versión
NEBO_APP_DATAAppq data/ directorionman ñan
PATHSistema PATH (pasachisqa)
HOMEUsuariopa home directorion (pasachisqa)
TMPDIRTemp directorio (pasachisqa)

Ancha chaniyuq: Binarioykiqa NEBO_APP_SOCKpi Unix socketta uyariq gRPC servidortam kamanan. Neboqa 10 segundokamam suyan kay socket rikhurinanpaq.

App Qallariy Ordenkuna

  1. Neboqa manifest.jsonta ñawinchan, validantaq
  2. App directoriopi binary utaq app ejecutableta tarin
  3. .quarantined marcata qhawan (cuarentenapi kaq appkunataqa mana qallarichinchu)
  4. Revocación qhaway (NeboAI rakisqan appkunallapaq)
  5. Firma verificación (NeboAI rakisqan appkunallapaq, devpi saltasqa)
  6. Binario validación (symlinkkunata, scriptkunata, mana ejecutablekunata, ancha hatun archivokunatapas mana chaskinchu)
  7. Ñawpaq purichiymanta mawk'a socketta pichan
  8. Sandboxpi waqaychanapaq data/ directoriota kaman
  9. Sapa apppaq log archivokunata wakichin (logs/stdout.log, logs/stderr.log)
  10. Binariota pichasqa entornowan, proceso huñu t'aqaywanpas qallarichin
  11. Unix socket rikhurinanta suyan (exponencial backoff, aswan 10 segundokuna)
  12. Unix socketpi gRPCwan t'inkikun
  13. providesman hina sapa atiypaq gRPC clientekunata kaman
  14. Qhali kay qhawayta purichin
  15. Atiykunata IA llamk'aqwan registran (herramientakuna, gateway, comm, hukkunapas)

Herramienta Appkuna

Manifiestoykipi "provides": ["tool:my_tool_name"]ta willay.

STRAP Patrón

Llapan Nebo herramienta appkunam esquemankupaq, purichiy pusayninkupaqpas STRAP (Single Tool Resource Action Pattern)ta llamk'achinanku chiqaptapuni. Kay kikin patrontam Neboqa ukhunpi llamk'achin 35+ sapaq herramientakunata 4 dominio herramientakunaman huñunanpaq — LLM contexto llasayta ~80% pisiyachispa.

Hatun yuyay: Achka herramientakunata registranapa rantinpi (get_events, check_availability, suggest_slots), HUK herramientallata registray action (munaspa resourcepas) camponkunawan, allin handlerman pusaq.

Huk recursoyuq qhawarichina (calendario):

calendar(action: "get_events", start: "2025-01-15T09:00:00Z", end: "2025-01-16T00:00:00Z")
calendar(action: "next_event")
calendar(action: "check_availability", start: "...", end: "...")
calendar(action: "suggest_slots", duration_minutes: 30, preferred_time: "morning")

Achka recursoyuq qhawarichina (proyecto kamachiq):

project(resource: "task", action: "create", title: "Ship v2", assignee: "alice")
project(resource: "task", action: "list", status: "open")
project(resource: "milestone", action: "create", name: "Beta", deadline: "2025-03-01")
project(resource: "milestone", action: "list")

Esquema kamachiykuna:

  1. Sapa kutim action campota churay necesitakuq string enum hina
  2. resource campota yapay (necesitakuq string enum) herramientayki achka hukniray recurso layakunata kamachiptinlla
  3. Hukkuna camponkunaqa sapa action-paq parámetrokunam
  4. action enum willakuynin llapan kaq actionkunata listanan

Imarayku STRAP chaniyuq:

  • LLMkunaqa action pusay patrontam huk kutilla yachanku, llapan ruwaykunapitaq llamk'achinku
  • Herramienta definicionkunaqa contextopa ~6%tam mikhunku — STRAPqa chayta 80% pisiyachin
  • Musuq ruwaykunaqa enum yapaykunallam, manam musuq herramienta registrokunachu
  • Alojasqa modelokunapi, kaypi modelokunapipas kikillantam llamk'an

Go Qhawarichina — Calculadora Herramienta

package main

import (
    "context"
    "encoding/json"
    "fmt"
    "log"

    nebo "github.com/neboloop/nebo-sdk-go"
)

type Calculator struct{}

func (c *Calculator) Name() string        { return "calculator" }
func (c *Calculator) Description() string { return "Performs arithmetic calculations." }

func (c *Calculator) Schema() json.RawMessage {
    return nebo.NewSchema("add", "subtract", "multiply", "divide").
        Number("a", "First operand", true).
        Number("b", "Second operand", true).
        Build()
}

func (c *Calculator) Execute(_ context.Context, input json.RawMessage) (string, error) {
    var in struct {
        Action string  `json:"action"`
        A      float64 `json:"a"`
        B      float64 `json:"b"`
    }
    if err := json.Unmarshal(input, &in); err != nil {
        return "", fmt.Errorf("invalid input: %w", err)
    }

    var result float64
    switch in.Action {
    case "add":
        result = in.A + in.B
    case "subtract":
        result = in.A - in.B
    case "multiply":
        result = in.A * in.B
    case "divide":
        if in.B == 0 {
            return "", fmt.Errorf("division by zero")
        }
        result = in.A / in.B
    default:
        return "", fmt.Errorf("unknown action: %s", in.Action)
    }

    return fmt.Sprintf("%g %s %g = %g", in.A, in.Action, in.B, result), nil
}

func main() {
    app, err := nebo.New()
    if err != nil {
        log.Fatal(err)
    }
    app.RegisterTool(&Calculator{})
    log.Fatal(app.Run())
}

manifest.json:

{
    "id": "com.example.calculator",
    "name": "Calculator",
    "version": "1.0.0",
    "description": "Arithmetic calculator tool for the agent",
    "runtime": "local",
    "protocol": "grpc",
    "provides": ["tool:calculator"],
    "permissions": []
}

Ruway, instalaypas:

go build -o binary .
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.calculator
cp binary manifest.json ~/Library/Application\ Support/Nebo/apps/com.example.calculator/

Rust Qhawarichina

use async_trait::async_trait;
use nebo_sdk::{NeboApp, NeboError, SchemaBuilder};
use nebo_sdk::tool::ToolHandler;
use serde::Deserialize;
use serde_json::Value;

struct Calculator;

#[derive(Deserialize)]
struct Input { action: String, a: f64, b: f64 }

#[async_trait]
impl ToolHandler for Calculator {
    fn name(&self) -> &str { "calculator" }
    fn description(&self) -> &str { "Performs arithmetic calculations." }
    fn schema(&self) -> Value {
        SchemaBuilder::new(&["add", "subtract", "multiply", "divide"])
            .number("a", "First operand", true)
            .number("b", "Second operand", true)
            .build()
    }
    async fn execute(&self, input: Value) -> Result<String, NeboError> {
        let i: Input = serde_json::from_value(input)
            .map_err(|e| NeboError::Execution(e.to_string()))?;
        let r = match i.action.as_str() {
            "add" => i.a + i.b,
            "subtract" => i.a - i.b,
            "multiply" => i.a * i.b,
            "divide" => {
                if i.b == 0.0 {
                    return Err(NeboError::Execution("division by zero".into()));
                }
                i.a / i.b
            }
            other => return Err(NeboError::Execution(format!("unknown action: {other}"))),
        };
        Ok(format!("{} {} {} = {}", i.a, i.action, i.b, r))
    }
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    NeboApp::new()?.register_tool(Calculator).run().await?;
    Ok(())
}

C Qhawarichina

#include <nebo/nebo.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

static int calculator_execute(const char *input_json, char **output, int *is_error) {
    /* Parse JSON, compute result, set *output */
    *output = strdup("2 add 3 = 5");
    *is_error = 0;
    return 0;
}

int main(void) {
    const char *actions[] = {"add", "subtract", "multiply", "divide", NULL};
    nebo_schema_builder_t *sb = nebo_schema_new(actions);
    nebo_schema_number(sb, "a", "First operand", 1);
    nebo_schema_number(sb, "b", "Second operand", 1);
    char *schema = nebo_schema_build(sb);
    nebo_schema_free(sb);

    nebo_tool_handler_t calculator = {
        .name = "calculator",
        .description = "Performs arithmetic calculations.",
        .schema = schema,
        .execute = calculator_execute,
    };

    nebo_app_t *app = nebo_app_new();
    nebo_app_register_tool(app, &calculator);
    int ret = nebo_app_run(app);
    free(schema);
    return ret;
}

Canal Appkuna

"provides": ["channel:my_channel"]ta, "permissions": ["channel:send"]tapas willay.

Canal appkunaqa hawa mensaje plataformakunatam (Telegram, Discord, Slack, hukkunapas) Neboq IA llamk'aqninman chakanku. Usuario hawa plataformapi mensajeta kachaptinqa, appniykim Receivewan Neboman streaman. IA llamk'aq kutichiyta munaptinqa, Neboqa appniykiq Sendninta waqyan.

Imaynam purin

  1. Neboqa ID()ta waqyan canalniykiq sapaq riqsichiqninta hap'inanpaq
  2. Neboqa Connect()ta waqyan appniykiq ajustekunanmanta configwan
  3. Neboqa Receive() streamta kichan — appniykim yaykuq mensajekunata kachan usuario botman qillqaptin
  4. Yaykuq mensajekunaqa IA llamk'aqpa hatun rimanakuy lanenmanmi pusasqa
  5. IA llamk'aq mensajeta kachayta munaptinqa, Neboqa Send()ta waqyan v1 mensaje envolturawan
  6. Wañuchikuptinqa, Neboqa Disconnect()ta waqyan

v1 Mensaje Envoltura

Llapan canal mensajekunam — yaykuqpas lluqsiqpas — kuska mensaje envolturata llamk'achinku:

{
  "message_id": "01953f8a-...",
  "channel_id": "telegram:12345",
  "sender": { "name": "Alex", "role": "COO", "bot_id": "uuid" },
  "text": "Q3 numbers look good...",
  "attachments": [{ "type": "image", "url": "https://...", "filename": "chart.png", "size": 45000 }],
  "reply_to": "01953f89-...",
  "actions": [{ "label": "Approve", "callback_id": "approve_q3" }],
  "platform_data": null,
  "timestamp": "2026-02-12T15:10:00Z"
}
CampoLayaWillakuy
message_idUUID v7Tiempoman hina churasqa sapaq ID
channel_id{type}:{platform_id}Pusana canal riqsichiq
senderobjectBot riqsichiy — suti, cargo, botId
textstringMensaje ukhun
attachmentsarrayArchivokuna, rikchakuna, audio
reply_toUUID v7Hilokunapaq tayta mensaje ID
actionsarrayInteractivo botonkuna/teclado
platform_databytesPlataformapa sapaq funcionninkunapaq mana rikukuq pasachiy
timestampISO 8601Uyarichiq kayta churan

Iskay capayuq diseño: Kuska camponkuna (text, attachments, reply_to, actions) llamk'aq qallarichisqan mensajekunapa 90%tam tapanku. Plataformapa sapaq funcionninkunaqa platform_datapim rinku — pluginniyki nativo plataforma formatoman/manta siq'in.

Rimanakuy Streamkuna

Canal mensajekunaqa sapa canalpaq rimanakuy streamkunapim pusasqa, t'aqasqa kanankupaq:

neboai/bot/{botID}/channels/{channelType}/inbound    # messages from users → agent
neboai/bot/{botID}/channels/{channelType}/outbound   # messages from agent → channel

Go Qhawarichina — Telegram Canal

package main

import (
    "context"
    "encoding/json"
    "fmt"
    "log"
    "time"

    "github.com/google/uuid"
    tgbot "github.com/go-telegram/bot"
    nebo "github.com/neboloop/nebo-sdk-go"
)

type Telegram struct {
    bot      *tgbot.Bot
    messages chan nebo.ChannelEnvelope
    cancel   context.CancelFunc
}

func (t *Telegram) ID() string { return "telegram" }

func (t *Telegram) Connect(_ context.Context, config map[string]string) error {
    token := config["bot_token"]
    if token == "" {
        return fmt.Errorf("bot_token is required")
    }

    botCtx, cancel := context.WithCancel(context.Background())
    t.cancel = cancel

    bot, err := tgbot.New(token, tgbot.WithDefaultHandler(
        func(bCtx context.Context, b *tgbot.Bot, update *tgbot.Update) {
            if update.Message == nil {
                return
            }
            env := nebo.ChannelEnvelope{
                MessageID: uuid.Must(uuid.NewV7()).String(),
                ChannelID: fmt.Sprintf("telegram:%d", update.Message.Chat.ID),
                Text:      update.Message.Text,
                Timestamp: time.Unix(int64(update.Message.Date), 0).UTC(),
            }
            t.messages <- env
        },
    ))
    if err != nil {
        return err
    }

    t.bot = bot
    go bot.Start(botCtx)
    return nil
}

func (t *Telegram) Send(ctx context.Context, env nebo.ChannelEnvelope) (string, error) {
    if t.bot == nil {
        return "", fmt.Errorf("not connected")
    }
    chatID := env.ChannelID[len("telegram:"):]
    params := &tgbot.SendMessageParams{
        ChatID: chatID,
        Text:   env.Text,
    }
    msg, err := t.bot.SendMessage(ctx, params)
    if err != nil {
        return "", err
    }
    return fmt.Sprintf("%d", msg.MessageID), nil
}

func (t *Telegram) Receive(_ context.Context) (<-chan nebo.ChannelEnvelope, error) {
    return t.messages, nil
}

func (t *Telegram) Disconnect(_ context.Context) error {
    if t.cancel != nil {
        t.cancel()
    }
    return nil
}

func main() {
    app, err := nebo.New()
    if err != nil {
        log.Fatal(err)
    }
    app.RegisterChannel(&Telegram{
        messages: make(chan nebo.ChannelEnvelope, 100),
    })
    log.Fatal(app.Run())
}

manifest.json:

{
    "id": "com.example.telegram",
    "name": "Telegram",
    "version": "1.0.0",
    "description": "Telegram messaging channel for Nebo",
    "runtime": "local",
    "protocol": "grpc",
    "provides": ["channel:telegram"],
    "permissions": ["channel:send", "network:outbound"],
    "settings": [
        {
            "key": "bot_token",
            "title": "Bot Token",
            "type": "password",
            "required": true,
            "description": "Telegram bot token from @BotFather",
            "secret": true
        }
    ]
}

Aswan Atiykuna

Comm App

"provides": ["comm"]ta, "permissions": ["comm:*"]tapas willay. Comm appkunaqa IA llamk'aqkuna purapi rimanakuytam atichinku.

CampoWillakuy
fromKachaq llamk'aq ID
toChaskiq llamk'aq ID
topicMensaje tema/canal
type"message", "mention", "proposal", "command", "info", "task"
contentMensaje ukhun

Hatun ruwaykuna:

  • Registerqa kay IA llamk'aqta redpi atiyninkunawan riqsichin
  • Subscribe/Unsubscribeqa tema suscripcionkunata kamachin
  • Receiveqa yaykuq mensajekunata streaman (server-streaming, canalkuna hina)
  • Huk comm appllam huk kutipi purinman

Gateway App

Gateway appqa LLM mañakuykunatam modelokunaman pusan. "provides": ["gateway"]ta, "permissions": ["network:outbound", "user:token"]tapas willay.

GatewayRequestqa mensajekunata, herramientakunata, sistema promptta, max tokenkunata, temperaturata, UserContexttapas (JWT token user:token permiso qusqa kaptin) apan.

GatewayEvent layakuna:

LayaContenidoWillakuy
"text"Qillqa partechaStreaming qillqa token
"tool_call"JSONModeloqa herramientata waqyayta munan
"thinking"Qillqa partechaYapasqa yuyaymanay/razonamiento
"error"Pantay mensajeImapas mana allinchu karqan
"done"Ch'usaqStreamqa tukusqañam

UI App

UI appqa Neboq kikin navegador ventananpi kichakuq personalizasqa configuración interfaztam qun. "provides": ["ui"]ta willay. Kikillanmanta ajustes formulariomanta hukniraymi (chaytaqa Nebo settings manifiestoykimanta rikuchin), UI appqa kikinpa llapan HTML/CSS/JS frontendnintam qun.

Appniykiqa ui/ directoriotam apan static web assetkunawan (HTML, CSS, JS — sapa kuti SPA index.htmlwan). Neboqa kay archivokunata chiqallanta qun, API waqyaykunatataq gRPCwan appniykiman proxyn.

ÑanMecanismoImapaq
GET /api/v1/apps/{id}/ui/*Static archivo servidorui/ directorioykimanta archivokunata qun (SPA index.htmlman kutin)
ANY /api/v1/apps/{id}/api/*gRPC proxyHTTP mañakuykunata appniykiq UIService.HandleRequest()ninman proxyn

SDKqa estándar net/http.ServeMuxtam p'istun, chhaynapi normal Go HTTP handlerkunata qillqanki — SDKqa gRPC chakaytam kikillanmanta ruwan.

Go Qhawarichina — Dashboard UI:

package main

import (
    "encoding/json"
    "log"
    "net/http"

    nebo "github.com/neboloop/nebo-sdk-go"
)

type Dashboard struct {
    mux *http.ServeMux
}

func NewDashboard() *Dashboard {
    d := &Dashboard{mux: http.NewServeMux()}

    d.mux.HandleFunc("GET /status", func(w http.ResponseWriter, r *http.Request) {
        json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
    })

    d.mux.HandleFunc("POST /action", func(w http.ResponseWriter, r *http.Request) {
        var req map[string]string
        json.NewDecoder(r.Body).Decode(&req)
        json.NewEncoder(w).Encode(map[string]string{"result": "done"})
    })

    return d
}

func (d *Dashboard) Handler() *http.ServeMux { return d.mux }

func main() {
    app, err := nebo.New()
    if err != nil {
        log.Fatal(err)
    }
    app.RegisterUI(NewDashboard())
    log.Fatal(app.Run())
}

ui/index.htmlniykiqa /api/v1/apps/com.example.dashboard/api/statusman fetch waqyaykunatam ruwanman, chaykunataq mux handlerniykiman proxysqa.

Schedule App

Schedule appqa Neboq kikin cron horario kamachiqnintam rantin. "provides": ["schedule"]ta, "permissions": ["schedule:create"]tapas willay.

Schedule appniyki qallarikuptinqa, Neboqa llapan horario kamachiytam appniykiman pusan ñawpaqmanta cron motorpa rantinpi. Appniyki p'akikuptinqa, Neboqa kikillanmantam kikin motorman kutin.

  • Appniykim horario estadota hap'in — Neboqa manam horariokunata kikinpa DBnpi waqaychanchu schedule app purishaptin
  • Estándar CRUD: Create, Get, List, Update, Delete, Enable, Disable
  • Triggersqa server-streaming RPCmi — appniykim trigger mensajeta kachan horario disparakuptin
  • Huk schedule appllam huk kutipi purinman

Achka Atiyniyuq Appkuna

Huk appqa achka atiykunatam quyta atin. Qhawarichinapaq, herramientayuq, UIyuqpas dashboard app:

{
    "id": "com.example.dashboard",
    "name": "Dashboard",
    "version": "1.0.0",
    "provides": ["tool:dashboard_query", "ui"],
    "permissions": ["network:outbound"]
}
app, _ := nebo.New()
app.RegisterTool(&dashboardTool{})
app.RegisterUI(&dashboardUI{})
log.Fatal(app.Run())

Paqueteay

.napp Formato

NeboAIwan rakinapaqqa, appniykita .napp archivo hina paqueteay (tar.gz archivo):

cd com.example.myapp/
tar -czf myapp-1.0.0.napp manifest.json binary signatures.json TOOL.md

Necesitakuq archivokuna:

ArchivoAswan Hatun KayWillakuy
manifest.json1 MBApp metadata
binary utaq app500 MBEjecutable
signatures.json1 MBEd25519 firmakuna
TOOL.md1 MBIA llamk'aqpaq herramienta kamachikuykuna

Hurquy ratupi seguridad kamachiykuna:

  • Mana ñan traversal (../ mana chaskisqa)
  • Mana symlinkkuna (mana chaskisqa)
  • Mana absoluto ñankuna (mana chaskisqa)
  • Allowlistpi kaq archivo sutikunallam chaskisqa

Firmakuna

NeboAIqa appkunatam Ed25519wan firman. signatures.json formato:

{
    "key_id": "a1b2c3d4",
    "algorithm": "ed25519",
    "manifest_signature": "<base64 signature of raw manifest.json bytes>",
    "binary_sha256": "<hex SHA256 of binary>",
    "binary_signature": "<base64 signature of raw binary bytes>"
}

Dev modopi (mana NeboAI URL configurasqa), firma verificaciónqa llapanmanta saltasqam. Kaypi desarrollaypaqqa manam signatures.jsonta necesitankichu.

Uyarichiy

Appniyki kaypi llamk'aptinqa, NeboAIwan uyarichiy llapan Nebo usuariokunaman rakinapaq.

Desarrollador Cuenta Wakichiy

  1. NeboAI cuentata registray POST /api/v1/owners/registerpi
  2. JWT tokenta hap'inaykipaq yaykuy: POST /api/v1/owners/login
  3. Desarrollador cuentata kamay: POST /api/v1/developer/accounts

Kachay Purikuy

draft → pending_review → [approved] → published
                       → [rejected] → draft (fix and resubmit)

Paso 1: Appta kamay

curl -X POST https://neboai.com/api/v1/developer/apps \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My App",
    "version": "1.0.0",
    "description": "What it does",
    "category": "productivity",
    "visibility": "public"
  }'

Paso 2: Plataforma binariokunata upload ruway

curl -X POST https://neboai.com/api/v1/developer/apps/{id}/binaries \
  -H "Authorization: Bearer $TOKEN" \
  -F "binary=@myapp-darwin-arm64" \
  -F "platform=darwin-arm64"

Sapa plataformapaq huk binariota upload ruway: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64.

Paso 3: Qhawarinapaq kachay

curl -X POST https://neboai.com/api/v1/developer/apps/{id}/submit \
  -H "Authorization: Bearer $TOKEN"

Qhawariy Proceso

  1. Automático qhawariy — binariokunaqa VirusTotalwanmi qhawasqa
  2. Admin qhawariy — NeboAI huñum metadatata, manifiestota, qhawariy resultadokunatapas qhawan
  3. Aprobasqa kaptin — NeboAIqa appta Ed25519wan firman, uyarichintaq
  4. Mana chaskisqa kaptin — imaraykuta chaskinki, allichaspataq yapamanta kachayta atinki

Qhawariy tiempo meta: <24 horas.

Musuqchaykunata Kachay

  1. Appa versiónninta musuqchay: PUT /api/v1/developer/apps/{id} musuq versiónwan
  2. Sapa plataformapaq musuq binariokunata upload ruway
  3. Yapamanta qhawarinapaq kachay

Sapa musuqchaymi kikin qhawariy procesota pasan. Ñawpaq versionkunaqa kallanmi musuq versión aprobasqa kanankama.

Store Metadata

CampoWillakuy
categoryqhawarichinapaq, productivity, communication, developer-tools
iconApp icono URL
visibilitypublic utaq private
descriptionManifiesto willakuymanta aswan hatun/aswan sumaq kanman

Dev Llamk'ay Purikuy

Kaypi Desarrollay

Kaypi desarrollaypaqqa mana paqueteay necesitakunchu:

  1. App directorioykita ruway:
    mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp
  2. manifest.jsonniykita, códigoykitapas qillqay
  3. Binarioykita ruway:
    go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary .
  4. Neboqa musuq directoriota kikillanmanta tarin (utaq Nebota hukmanta qallarichiy)
  5. Código tikrasqa qhipaqa, binariota hukmanta ruway — archivo qhawaqmi appta hukmanta qallarichinqa

Logkunata Qhaway

App stdout/stderrqa sapa apppaq log archivokunapim hap'isqa:

tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stdout.log
tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stderr.log

Wiñay Willakuykuna

data/ directoriota llamk'achiy (NEBO_APP_DATA env var hinapas kan) appniyki waqaychanan mayqin archivokunapaqpas. Kay directorioqa app musuqchaykunatapas cuarentenatapas atipanmi.

Allichanapaq Yuyaychaykuna

  • Appniyki mana qallarikuptinqa, pantaykunapaq logs/stderr.logta qhaway
  • Binario ejecutable kasqanta qhaway (chmod +x binary)
  • Qhaway NEBO_APP_SOCKmanta Unix socket ñanpi uyarishasqaykita
  • Socketqa qallarisqamanta 10 segundokunapim listo kanan
  • Waqaychanapaq NEBO_APP_DATAta llamk'achiy, manam códigopi churasqa ñankunatachu
  • Debug logpaq stderrman qillqay (logs/stderr.logpi hap'isqa)

Verificay

# List installed apps
nebo apps list

# Check running apps via the web UI Settings > Apps
# Or check the apps directory for running sockets
ls ~/Library/Application\ Support/Nebo/apps/*/app.sock

Desinstalay

nebo apps uninstall com.example.myapp

Atiykuna

Atiykuna ima kasqanku

Atiykunaqa rimanakuypi Nebo imayna ruwananta siq'iq kamachikuy huñukunam. Atiy purishaptinqa, contenidonmi sistema promptman chiqallanta churakun — IA llamk'aqpa rimay laynintam, methodonta, yachayninta, herramienta llamk'achiynintapas chay sesiónpaq pusan.

Atiykunaqa manam códigochu. YAML metadatayuq markdown qillqakunam. Mana compilación, mana binario, mana gRPC. Atiyqa directoriopi huk SKILL.md archivom. Chayllam.

Atiykunaqa contextoman hina, pisi tiempopaqmi. Necesitakuptin prendekunku (trigger tupaywan utaq makiwan cargaspa), wakin turnokunata kanku, manaña necesitakuptintaq tukukunku. Chhaynapim IA llamk'aqpa contexton llañu kan — kunan chaniyuq pusaylla promptpi kan.

Atiykunaqa appkunatam hunt'anku. Appkunaqa purichina atiykunatam qunku (herramientakuna, canalkuna, gatewaykuna). Atiykunaqa kamachiy pusaytam qunku — chay herramientakunata imayna allinta llamk'achinapaq. Calendario appqa Neboman eventokunata ñawinchanapaq, qillqanapaqpas atiyta qun. "Tupanakuy wakichiy" atiyqa Nebomanmi willan tupanakuykunapaq imayna wakichikunanta, chay calendario appta, correota, web maskhaytapas kuska llamk'achispa.

Atiykuna Appkunapas

AtiykunaAppkuna
FormatoMarkdown (SKILL.md)Compilasqa binario (.napp)
PurichiySistema promptman churasqagRPCwan sandboxpi proceso
QunRuway pusay, métodoHerramientakuna, canalkuna, UI panelkuna
Kawsay tiempoSesiónpaq, TTLman hina tukukunSapa kuti purishan
KamayMarkdown archivota qillqayQillqay, compilay, firmay, paqueteay
SeguridadMana permisokuna necesitakunchuÑawpaqmanta mana permisoyuq sandbox

Usqhay Qallariy

Nebo atiykuna carpetaykipi SKILL.md archivoyuq directoriota kamay:

~/Library/Application Support/Nebo/skills/   # macOS
~/.config/nebo/skills/                        # Linux
%AppData%\Nebo\skills\                        # Windows
mkdir -p ~/.config/nebo/skills/my-skill

SKILL.mdta qillqay:

---
name: my-skill
description: One-line description of what this skill does
version: "1.0.0"
triggers:
  - keyword that activates this skill
  - another trigger phrase
---

# My Skill

Instructions for Nebo when this skill is active.

Tell the agent what to do, how to approach problems,
what tools to use, and what tone to take.

Neboqa atiykuna directoriotam fsnotifywan qhawapan. Atiykiqa chayllam kapun — mana hukmanta qallarichiy necesitakunchu. Huk triggerwan tupaq imatapas niy, kikillanmantataq prendekunqa.

Utaq Nebota chiqallanta mañakuy: "Blog qillqakunata qillqanapaq atiyta kamay" — Nebom SKILL.md archivota qampaq qillqanqa.

SKILL.md Formato

Sapa atiymi huk SKILL.md archivolla iskay parteyuq: --- marcakuna chawpipi YAML frontmatter, markdown ukhupas (sistema promptman churakuq chiqap kamachikuykuna).

CampoNecesitakunÑawpaqmantaWillakuy
nameArí—Sapaq riqsichiq (slugman tikrakun)
descriptionArí—Atiy catálogopi rikuchisqa huk siruyuq willakuy
versionManam"1.0.0"Musuqchaykunata qatinapaq semver
authorManam—Atiy ruwaq
priorityManam0Aswan hatun = ñawpaqta tupachisqa (100+ ancha chaniyuq rantinakunapaq)
max_turnsManam4Kikillanmanta tukukunanpaq mana llamk'aq turnokuna
triggersManam[]Kay atiyta kikillanmanta prendeq rimaykuna (hatun/huch'uy letrata mana qhawaspa substring tupay)
toolsManam[]Kay atiy llamk'achinanta suyasqan herramientakuna (willakunapaq)
dependenciesManam[]Instalasqa kanan huk atiykuna
tagsManam[]T'aqanapaq, tarinapaqpas
platformManam[]Atisqa plataformakuna: macos, linux, windows (ch'usaq = llapan)

Imaynatam Atiykuna Prendekunku

Atiykunaqa iskay fase prendekuy modelotam qatinku: yuyarichiy, chaymanta waqyay.

Fase 1: Trigger Tupay — Sapa kuti usuario mensajeta kachaptinmi, Neboqa llapan registrasqa atiykunatam qhawan trigger tupaykunapaq. Tupaq atiykunaqa sistema promptpim yuyarichiy hina rikhurinku. IA llamk'aqmi yuyarichiyta rikun, akllantaq atiyta waqyananta utaq mana.

Fase 2: Waqyay — IA llamk'aqqa atiytam waqyan kayta waqyaspa:

skill(name: "code-review")

Kayqa llapan SKILL.md plantillatam herramienta resultado hina kutichin, waqyayta qillqan, qatiq turnokunapitaq plantillata sistema promptman hukmanta churan.

TTL, Tukukuypas:

  • Kikillanmanta tupachisqa atiykuna: 4 mana llamk'aq turnokuna (max_turnswan configurana)
  • Makiwan cargasqa atiykuna: 6 mana llamk'aq turnokuna
  • Hukmanta waqyayqa relojta qallarichinmi
  • Sinchi saywa: sapa sesiónpi aswan 4 purishaq atiykuna
  • Token presupuesto: purishaq atiykunaq contenidon kuska 16,000 letrakamam

Atiykunata Kamachiy

IA llamk'aqqa skill herramientawanmi atiykunata kamachiyta atin:

RuwayWillakuyQhawarichina
catalogLlapan kaq atiykunata listayskill(action: "catalog")
loadKay sesiónpaq prendeyskill(name: "code-review", action: "load")
unloadAtiyta wañuchiyskill(name: "code-review", action: "unload")
createDiskopi musuq atiyta kamayskill(action: "create", content: "...")
updateKaq atiyta musuqchayskill(name: "my-skill", action: "update", content: "...")
deleteDiskomanta atiyta qulluchiyskill(name: "my-skill", action: "delete")

Allin Atiykunata Qillqay

Allin atiy plantillaqa kaykunayuqmi:

  1. Sut'i umalliq — IA llamk'aqman ima modopi kasqanta willan
  2. Hatun principiokuna — mana tikrakuq ruway kamachiykuna
  3. Método — riqsisqa kaqkunapaq paso paso ruway
  4. Qhawarichinakuna — chiqap usuario mensajemanta kutichiykama patronkuna
  5. Anti-patronkuna — ima MANA ruwanapaq (modelokunaqa mana allin qhawarichinakunamanta allintam yachanku)

Yuyaychay: Sapa atiymi huk kaqllata allinta ruwanan. Ama "llapan programación" atiyta kamaychu — code-review, debugging, api-designta sapaq atiykuna hina kamay. IA llamk'aqqa achkatam kuska purichiyta atin.

Kuska Hamuq Atiykuna

Neboqa riqsisqa llamk'aykunata tapaq kuska atiykunawanmi hamun:

AtiyÑawpaqchayWillakuy
onboarding100Musuq usuariota napaykuy, perfilta huñuypas
best-friend50Personalidad atiy — casual, hunt'aq, chiqap rimay
debugging25Sistemático debugging método
api-design15RESTful API diseñopaq aswan allin ruwaykuna
code-review10Severidad nivelkunayuq churasqa código qhawariy
database-expert10Base de datos diseño, consultakuna, optimización
git-workflow10Git branchkuna, commitkuna, PR llamk'ay purikuykuna
security-audit10Seguridad qhawariy, vulnerabilidad tariypas

Kaykunaqa allin ñawpaqmanta kaqkuna, kikiykiq atiykunata kamanapaq referencia ruwaykunapas.

Referencia

Proto Archivokuna

Proto archivokunaqa proto/apps/v0/pim tiyanku. SDKkunaqa ñawpaqmanta ruwasqa códigowanmi hamunku, chhaynapi normal desarrollaypaqqa manam protocta necesitankichu.

ArchivoServicioHatun RPCkuna
v0/common.proto(mensajekunalla)HealthCheckRequest/Response, SettingsMap, UserContext, Empty
v0/tool.protoToolServiceName, Description, Schema, Execute, RequiresApproval, Configure
v0/channel.protoChannelServiceID, Connect, Disconnect, Send, Receive (stream), Configure
v0/comm.protoCommServiceName, Version, Connect, Disconnect, Send, Subscribe, Register, Receive (stream), Configure
v0/gateway.protoGatewayServiceHealthCheck, Stream (stream), Poll, Cancel, Configure
v0/ui.protoUIServiceHealthCheck, HandleRequest, Configure
v0/schedule.protoScheduleServiceHealthCheck, Create, Get, List, Update, Delete, Enable, Disable, Trigger, History, Triggers (stream), Configure

Sapa serviciom HealthCheck, Configure RPCkunayuq. SDKqa iskayninta kikillanmanta ruwan.

Canal Proto Layakuna

Mensaje LayaWillakuy
ChannelSendRequestLluqsiq mensaje envoltura message_id, channelId, sender, text, attachments, reply_to, actions, platform_datawan
ChannelSendResponseHilokunapaq plataforma mensaje ID
InboundMessageYaykuq mensaje envoltura llapan kuska camponkunawan + timestamp
MessageSenderBot riqsichiy (name, role, botId) — brokermi yapan
AttachmentArchivo/rikcha/audio yapasqa (type, url, filename, size)
MessageActionInteractivo boton/teclado ruway (label, callback_id)

Bot Riqsichiy, Cargokunapas

Nebo botkunaqa kimsa ejeyuq riqsichiy modelotam hap'inku:

  • creature — Bot ima kasqan (arquetipo): "Usqhay yuyayniyuq estratega", "Allinta qhawaq maskhaq"
  • role — Usuariowan imayna tupasqan (relación): "Amigo", "COO", "Mentor"
  • vibe — Kallpan (rimay estilo): "Thak ichaqa yuyayniyuq", "Q'uñi, kallpachaqpas"

Canal pluginniyki lluqsiq mensajeta chaskiptinqa, sender campopim botpa namenin, rolenin kan. Kayta llamk'achiy plataformaykipaq rikuchina sutita formatonanpaq. Cargoqa manam llamk'ay sutichu — relación willakuymi. "Amigo", "Churi", "Mentor"pas allin cargokunam "COO", "DevLead" kaqkunawan kuska.