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.
| Estado | Simikuna |
|---|---|
| Atisqa | Go (yuyaychasqa), Rust, C/C++, Zig |
| Mana chaskisqa | Python, 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
manifest.jsonta kamayid,name,version,provideswanTOOL.mdta qillqay IA llamk'aq herramientaykita imayna llamk'achinanta willaspa- SDKta instalay (
go get github.com/neboloop/nebo-sdk-go) - Atiyniykipaq handler interfazta ruway (
ToolHandler,ChannelHandler, hukkunapas) - Handlerta registray,
app.Run()tataq waqyay - Nativo binariota ruway (
go build -o binary .) - Binario + manifest.json + TOOL.mdta
apps/<your-app-id>/directoriopi churay - 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:
| Campo | Willakuy |
|---|---|
id | Kutiq-dominio riqsichiq (qhawarichinapaq, com.mycompany.myapp) |
name | Runa ñawinchanan suti |
version | Semver qillqa |
provides | Yaqa huk atiy (uraypi qhaway) |
Munaspa camponkuna:
| Campo | Ñawpaqmanta | Willakuy |
|---|---|---|
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:
| Atiy | gRPC Servicio | Willakuy |
|---|---|---|
gateway | GatewayService | LLM modelo pusay |
tool:<name> | ToolService | IA llamk'aqpaq sutiyuq herramienta |
channel:<name> | ChannelService | Mensaje canal |
comm | CommService | IA llamk'aqkuna purapi rimanakuy |
ui | UIService | HTTP proxywan personalizasqa UI |
schedule | ScheduleService | Personalizasqa horario |
vision | ToolService | Rikuy procesamiento |
browser | ToolService | Navegador 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.
| Prefijo | Qhawarichinakuna | Willakuy |
|---|---|---|
network: | network:outbound, network:* | Redman yaykuy |
filesystem: | filesystem:read, filesystem:write | Archivo sistemaman yaykuy |
memory: | memory:read, memory:write | IA llamk'aqpa yuyayninman yaykuy |
session: | session:read | Rimanakuy sesionkuna |
tool: | tool:shell, tool:file | Huk herramientakunata llamk'achiy |
shell: | shell:exec | Shell kamachikuykunata purichiy |
channel: | channel:send, channel:* | Canal ruwaykuna |
comm: | comm:send, comm:* | IA llamk'aqkuna purapi rimanakuy |
model: | model:chat | IA modeloman yaykuy |
user: | user:token | Mañakuykunapi usuario JWTta chaskiy |
schedule: | schedule:create | Cron llamk'ay kamachiy |
database: | database:query | Base de datosman yaykuy |
storage: | storage:read, storage:write | Wiñay waqaychana |
context: | context:read | IA llamk'aqpa contextonman yaykuy |
subagent: | subagent:spawn | Sub-agent ruwaykuna |
lane: | lane:enqueue | Lane ruwaykuna |
notification: | notification:send | Push willakuykuna |
embedding: | embedding:search | Vector embeddingman yaykuy |
skill: | skill:invoke | Atiyta waqyay |
advisor: | advisor:consult | Advisor sistemaman yaykuy |
mcp: | mcp:connect | MCP servidorman yaykuy |
voice: | voice:record | Kunka/audioman yaykuy |
browser: | browser:navigate | Navegador automatización |
oauth: | oauth:google, oauth:* | OAuth tokenman yaykuy |
settings: | settings:read | Ajustekunaman yaykuy |
capability: | capability:register | Atiy 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.
| Laya | Willakuy |
|---|---|
text | Huk siruyuq qillqa yaykuy |
password | Pakasqa qillqa yaykuy |
toggle | Boolean prendey/wañuchiy switch |
select | Ñawpaqmanta churasqa akllanakunayuq dropdown |
number | Yupay yaykuy |
url | Validació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"]
}
]
} | Campo | Willakuy |
|---|---|
provider | OAuth proveedor: "google", "microsoft", "github" |
scopes | Appq 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:
| Variable | Chanin |
|---|---|
NEBO_APP_DIR | Appq instalación directorion |
NEBO_APP_SOCK | Kamana Unix socketman ñan |
NEBO_APP_ID | Manifiestomanta App ID |
NEBO_APP_NAME | Manifiestomanta App suti |
NEBO_APP_VERSION | Manifiestomanta App versión |
NEBO_APP_DATA | Appq data/ directorionman ñan |
PATH | Sistema PATH (pasachisqa) |
HOME | Usuariopa home directorion (pasachisqa) |
TMPDIR | Temp directorio (pasachisqa) |
Ancha chaniyuq: Binarioykiqa NEBO_APP_SOCKpi Unix socketta uyariq gRPC servidortam kamanan. Neboqa 10 segundokamam suyan kay socket rikhurinanpaq.
App Qallariy Ordenkuna
- Neboqa
manifest.jsonta ñawinchan, validantaq - App directoriopi
binaryutaqappejecutableta tarin .quarantinedmarcata qhawan (cuarentenapi kaq appkunataqa mana qallarichinchu)- Revocación qhaway (NeboAI rakisqan appkunallapaq)
- Firma verificación (NeboAI rakisqan appkunallapaq, devpi saltasqa)
- Binario validación (symlinkkunata, scriptkunata, mana ejecutablekunata, ancha hatun archivokunatapas mana chaskinchu)
- Ñawpaq purichiymanta mawk'a socketta pichan
- Sandboxpi waqaychanapaq
data/directoriota kaman - Sapa apppaq log archivokunata wakichin (
logs/stdout.log,logs/stderr.log) - Binariota pichasqa entornowan, proceso huñu t'aqaywanpas qallarichin
- Unix socket rikhurinanta suyan (exponencial backoff, aswan 10 segundokuna)
- Unix socketpi gRPCwan t'inkikun
providesman hina sapa atiypaq gRPC clientekunata kaman- Qhali kay qhawayta purichin
- 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:
- Sapa kutim
actioncampota churay necesitakuq string enum hina resourcecampota yapay (necesitakuq string enum) herramientayki achka hukniray recurso layakunata kamachiptinlla- Hukkuna camponkunaqa sapa action-paq parámetrokunam
actionenum willakuynin llapan kaq actionkunata listanan
Imarayku STRAP chaniyuq:
- LLMkunaqa
actionpusay 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
- Neboqa
ID()ta waqyan canalniykiq sapaq riqsichiqninta hap'inanpaq - Neboqa
Connect()ta waqyan appniykiq ajustekunanmanta configwan - Neboqa
Receive()streamta kichan — appniykim yaykuq mensajekunata kachan usuario botman qillqaptin - Yaykuq mensajekunaqa IA llamk'aqpa hatun rimanakuy lanenmanmi pusasqa
- IA llamk'aq mensajeta kachayta munaptinqa, Neboqa
Send()ta waqyan v1 mensaje envolturawan - 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"
} | Campo | Laya | Willakuy |
|---|---|---|
message_id | UUID v7 | Tiempoman hina churasqa sapaq ID |
channel_id | {type}:{platform_id} | Pusana canal riqsichiq |
sender | object | Bot riqsichiy — suti, cargo, botId |
text | string | Mensaje ukhun |
attachments | array | Archivokuna, rikchakuna, audio |
reply_to | UUID v7 | Hilokunapaq tayta mensaje ID |
actions | array | Interactivo botonkuna/teclado |
platform_data | bytes | Plataformapa sapaq funcionninkunapaq mana rikukuq pasachiy |
timestamp | ISO 8601 | Uyarichiq 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.
| Campo | Willakuy |
|---|---|
from | Kachaq llamk'aq ID |
to | Chaskiq llamk'aq ID |
topic | Mensaje tema/canal |
type | "message", "mention", "proposal", "command", "info", "task" |
content | Mensaje ukhun |
Hatun ruwaykuna:
Registerqa kay IA llamk'aqta redpi atiyninkunawan riqsichinSubscribe/Unsubscribeqa tema suscripcionkunata kamachinReceiveqa 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:
| Laya | Contenido | Willakuy |
|---|---|---|
"text" | Qillqa partecha | Streaming qillqa token |
"tool_call" | JSON | Modeloqa herramientata waqyayta munan |
"thinking" | Qillqa partecha | Yapasqa yuyaymanay/razonamiento |
"error" | Pantay mensaje | Imapas mana allinchu karqan |
"done" | Ch'usaq | Streamqa 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.
| Ñan | Mecanismo | Imapaq |
|---|---|---|
GET /api/v1/apps/{id}/ui/* | Static archivo servidor | ui/ directorioykimanta archivokunata qun (SPA index.htmlman kutin) |
ANY /api/v1/apps/{id}/api/* | gRPC proxy | HTTP 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:
| Archivo | Aswan Hatun Kay | Willakuy |
|---|---|---|
manifest.json | 1 MB | App metadata |
binary utaq app | 500 MB | Ejecutable |
signatures.json | 1 MB | Ed25519 firmakuna |
TOOL.md | 1 MB | IA 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
- NeboAI cuentata registray
POST /api/v1/owners/registerpi - JWT tokenta hap'inaykipaq yaykuy:
POST /api/v1/owners/login - 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
- Automático qhawariy — binariokunaqa VirusTotalwanmi qhawasqa
- Admin qhawariy — NeboAI huñum metadatata, manifiestota, qhawariy resultadokunatapas qhawan
- Aprobasqa kaptin — NeboAIqa appta Ed25519wan firman, uyarichintaq
- Mana chaskisqa kaptin — imaraykuta chaskinki, allichaspataq yapamanta kachayta atinki
Qhawariy tiempo meta: <24 horas.
Musuqchaykunata Kachay
- Appa versiónninta musuqchay:
PUT /api/v1/developer/apps/{id}musuq versiónwan - Sapa plataformapaq musuq binariokunata upload ruway
- Yapamanta qhawarinapaq kachay
Sapa musuqchaymi kikin qhawariy procesota pasan. Ñawpaq versionkunaqa kallanmi musuq versión aprobasqa kanankama.
Store Metadata
| Campo | Willakuy |
|---|---|
category | qhawarichinapaq, productivity, communication, developer-tools |
icon | App icono URL |
visibility | public utaq private |
description | Manifiesto willakuymanta aswan hatun/aswan sumaq kanman |
Dev Llamk'ay Purikuy
Kaypi Desarrollay
Kaypi desarrollaypaqqa mana paqueteay necesitakunchu:
- App directorioykita ruway:
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp manifest.jsonniykita, códigoykitapas qillqay- Binarioykita ruway:
go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary . - Neboqa musuq directoriota kikillanmanta tarin (utaq Nebota hukmanta qallarichiy)
- 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
| Atiykuna | Appkuna | |
|---|---|---|
| Formato | Markdown (SKILL.md) | Compilasqa binario (.napp) |
| Purichiy | Sistema promptman churasqa | gRPCwan sandboxpi proceso |
| Qun | Ruway pusay, método | Herramientakuna, canalkuna, UI panelkuna |
| Kawsay tiempo | Sesiónpaq, TTLman hina tukukun | Sapa kuti purishan |
| Kamay | Markdown archivota qillqay | Qillqay, compilay, firmay, paqueteay |
| Seguridad | Mana 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).
| Campo | Necesitakun | Ñawpaqmanta | Willakuy |
|---|---|---|---|
name | Arí | — | Sapaq riqsichiq (slugman tikrakun) |
description | Arí | — | Atiy catálogopi rikuchisqa huk siruyuq willakuy |
version | Manam | "1.0.0" | Musuqchaykunata qatinapaq semver |
author | Manam | — | Atiy ruwaq |
priority | Manam | 0 | Aswan hatun = ñawpaqta tupachisqa (100+ ancha chaniyuq rantinakunapaq) |
max_turns | Manam | 4 | Kikillanmanta tukukunanpaq mana llamk'aq turnokuna |
triggers | Manam | [] | Kay atiyta kikillanmanta prendeq rimaykuna (hatun/huch'uy letrata mana qhawaspa substring tupay) |
tools | Manam | [] | Kay atiy llamk'achinanta suyasqan herramientakuna (willakunapaq) |
dependencies | Manam | [] | Instalasqa kanan huk atiykuna |
tags | Manam | [] | T'aqanapaq, tarinapaqpas |
platform | Manam | [] | 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:
| Ruway | Willakuy | Qhawarichina |
|---|---|---|
catalog | Llapan kaq atiykunata listay | skill(action: "catalog") |
load | Kay sesiónpaq prendey | skill(name: "code-review", action: "load") |
unload | Atiyta wañuchiy | skill(name: "code-review", action: "unload") |
create | Diskopi musuq atiyta kamay | skill(action: "create", content: "...") |
update | Kaq atiyta musuqchay | skill(name: "my-skill", action: "update", content: "...") |
delete | Diskomanta atiyta qulluchiy | skill(name: "my-skill", action: "delete") |
Allin Atiykunata Qillqay
Allin atiy plantillaqa kaykunayuqmi:
- Sut'i umalliq — IA llamk'aqman ima modopi kasqanta willan
- Hatun principiokuna — mana tikrakuq ruway kamachiykuna
- Método — riqsisqa kaqkunapaq paso paso ruway
- Qhawarichinakuna — chiqap usuario mensajemanta kutichiykama patronkuna
- 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 | Ñawpaqchay | Willakuy |
|---|---|---|
onboarding | 100 | Musuq usuariota napaykuy, perfilta huñuypas |
best-friend | 50 | Personalidad atiy — casual, hunt'aq, chiqap rimay |
debugging | 25 | Sistemático debugging método |
api-design | 15 | RESTful API diseñopaq aswan allin ruwaykuna |
code-review | 10 | Severidad nivelkunayuq churasqa código qhawariy |
database-expert | 10 | Base de datos diseño, consultakuna, optimización |
git-workflow | 10 | Git branchkuna, commitkuna, PR llamk'ay purikuykuna |
security-audit | 10 | Seguridad 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.
| Archivo | Servicio | Hatun RPCkuna |
|---|---|---|
v0/common.proto | (mensajekunalla) | HealthCheckRequest/Response, SettingsMap, UserContext, Empty |
v0/tool.proto | ToolService | Name, Description, Schema, Execute, RequiresApproval, Configure |
v0/channel.proto | ChannelService | ID, Connect, Disconnect, Send, Receive (stream), Configure |
v0/comm.proto | CommService | Name, Version, Connect, Disconnect, Send, Subscribe, Register, Receive (stream), Configure |
v0/gateway.proto | GatewayService | HealthCheck, Stream (stream), Poll, Cancel, Configure |
v0/ui.proto | UIService | HealthCheck, HandleRequest, Configure |
v0/schedule.proto | ScheduleService | HealthCheck, 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 Laya | Willakuy |
|---|---|
ChannelSendRequest | Lluqsiq mensaje envoltura message_id, channelId, sender, text, attachments, reply_to, actions, platform_datawan |
ChannelSendResponse | Hilokunapaq plataforma mensaje ID |
InboundMessage | Yaykuq mensaje envoltura llapan kuska camponkunawan + timestamp |
MessageSender | Bot riqsichiy (name, role, botId) — brokermi yapan |
Attachment | Archivo/rikcha/audio yapasqa (type, url, filename, size) |
MessageAction | Interactivo 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.