Programas en este Mac (API local)
Deja que otros programas de tu Mac hablen con tus Nobreiniers con la API de chat estándar que usan muchos programas. Apagada hasta que la enciendas, solo este Mac, una llave por programa.
Muchos programas (editores, herramientas de escritura, scripts) pueden hablar con una IA a través de una API de chat estándar. NoBreiniers puede responderles en tu Mac, así esos programas usan a tus Nobreiniers: Breini, o cualquier Nobreinier de tu negocio.
Enciéndela
- Abre Ajustes › Programas en este Mac.
- Enciende Dejar que los programas de este Mac usen a tus Nobreiniers.
- Copia la Dirección para el programa. Se ve así:
http://127.0.0.1:47615/v1.
Está apagada hasta que la enciendas. Mientras está apagada, nada en tu Mac escucha a los programas.
Una llave para cada programa
- En Una llave para cada programa, escribe el nombre del programa (por ejemplo, "mi editor") y pulsa +.
- Copia la llave enseguida. Solo se muestra esta vez.
- En los ajustes del programa, pega la dirección como su "base URL" y la llave como su "API key".
La lista muestra el nombre de cada llave, cuándo la creaste y cuándo y qué programa la usó por última vez. Para quitarle el acceso a un programa, pulsa la papelera junto a su llave y confirma. Esa llave deja de funcionar al instante, y todo lo que el programa tiene en marcha se detiene con ella, también lo que espera en fila.
NoBreiniers guarda solo una huella de cada llave, nunca la llave. Si pierdes una llave, revócala y crea otra.
Lo que un programa puede pedir
- El modelo es el Nobreinier que responde:
breini, o el nombre de un Nobreinier. El programa puede leer la lista enGET /v1/models. Sin modelo, responde Breini. - Chat:
POST /v1/chat/completions, con la respuesta entera o palabra a palabra ("stream": true). - Responses:
POST /v1/responses, coninput,instructionsyprevious_response_id, también palabra a palabra. - Por ahora, solo texto. Un programa que manda sus propias herramientas o imágenes, o pide varias respuestas a la vez, recibe un error claro en lugar de una respuesta a medias.
Apps de agentes (MCP)
Las apps de agentes que hablan MCP (el Model Context Protocol) pueden darles tareas a tus Nobreiniers. Ajustes › Programas en este Mac › Apps de agentes muestra dos maneras, cada una lista para copiar en los servidores MCP de la app:
- Con la línea de comandos de NoBreiniers. La app ejecuta
osirisbrain mcp servey trabaja como tú en tu línea de comandos: las mismas carpetas, los mismos permisos. No necesita llave. - En su dirección, con una llave. La app se conecta a
http://127.0.0.1:47615/mcp(tu puerto, si lo cambiaste) con una llave que le creas abajo. Trabaja como un programa: en chats propios, y todo lo de abajo vale para ella. Pon la llave en el archivo de ajustes de la app, o en una variableNOBREINIERS_KEYque ese archivo nombre. Nunca escribas una llave en una línea de comandos.
En Linux solo se muestra la segunda manera: ahí NoBreiniers corre como un usuario propio, así que la app de agentes se conecta en la dirección, con una llave.
Por la dirección, la app tiene estas herramientas:
- ask: dale a Breini, o a un Nobreinier por su nombre, una tarea o una pregunta y espera la respuesta. La app ve lo que hace mientras trabaja.
- start_task, task_status, stop_task: empieza una tarea larga, síguela (en fila, trabajando en un paso, esperando tu sí, lista) y detenla.
- list_agents: quién puede tomar una tarea.
- list_conversations, read_conversation: los chats que la propia app empezó. Nunca ve tus otros chats.
Para seguir en la conversación de una tarea, la app pasa su id, y el mismo Nobreinier responde en el mismo chat.
- Cuando un programa detiene su propia tarea, o tú revocas su llave, también se detienen los ayudantes y los comandos en segundo plano que esa tarea inició; tu propio trabajo en el mismo chat sigue.
- Un programa no puede acaparar tu Mac: si está ocupado, sus tareas esperan su turno y arrancan solas.
- Tampoco puede ocupar todo el espacio del Mac para que lo atiendan: cuando una llave ya tiene su parte de lo que el Mac puede atender a la vez, su siguiente petición recibe una respuesta de "demasiadas peticiones" (estado 429) que dice en cuántos segundos reintentar (
Retry-After). Un lote de una app de agentes recibe esa misma respuesta solo para las peticiones que no pudo tomar (error -32029, conretryAfter), y las demás se responden. Los otros programas, y tú, se atienden como siempre. - Al pausar todo el trabajo automático también se pausa lo que pidieron los programas: sus tareas en curso se detienen y las nuevas esperan hasta que lo reanudes.
- Cuando detienes un chat, también se cancelan las tareas de programas que esperaban en él.
- Si detienes un chat con mensajes en su cola, esos mensajes te esperan; una tarea de un programa en ese chat corre por su cuenta y no los envía.
- La respuesta de una tarea se puede leer mientras su chat exista, también después de que NoBreiniers se reinicie.
Lo que un programa nunca puede hacer
Un programa escribe como él mismo, nunca como tú:
- Cada conversación tiene su propio chat en tu barra lateral, con el nombre del programa. Nunca toma el chat que tienes en pantalla.
- El chat trabaja con el nivel de permiso con el que empiezan los chats nuevos, y con tus aprobaciones: cuando su trabajo necesita tu sí, la tarjeta espera tu clic, y el programa espera también.
- Un programa no puede cambiar tus ajustes, responder tus aprobaciones o preguntas, ver tus llaves ni actuar "por orden tuya". Sus palabras nunca se leen como comandos: un mensaje como
/permission …es solo texto. - Lo que manda se trata como contenido de fuera, igual que una página web: lo que sale de tu Mac pasa por los mismos controles.
Solo este Mac
- La dirección solo funciona desde este Mac. Las otras computadoras de tu red no la alcanzan.
- Las páginas web de un navegador no pueden usarla, ni siquiera en este Mac.
- Para cambiar el puerto, pulsa el lápiz junto a la dirección. Si otro programa ya usa ese puerto, NoBreiniers te lo dice y deja el anterior.
