Repolode
oguzbilgic

oguzbilgic/kern-ai

Um runtime de agentes de longa duração que funciona nos seus apps de chat (Slack, Matrix, Telegram, Discord, IRC, Nostr), com memória persistente e tarefas em segundo plano.

Estrelas
72
Forks
13
Issues abertas
72
Último commit
há 14 dias

O que é?

kern executa um agente de IA como um processo de longa duração, com uma única memória persistente, acessível pelo Slack, Matrix, Telegram, Discord, IRC, Nostr e por uma interface de terminal. Cada agente é configurado com um nome, uma chave de provedor de modelo e uma conta de bot, e roda em seu próprio contêiner Docker, com um volume que armazena sessões, memória, notas e ferramentas instaladas.

O agente divide as conversas por tópico, resume o conteúdo em uma hierarquia e recupera contexto antigo por meio de busca semântica. Ele pode executar comandos shell longos como tarefas em segundo plano, que enviam os resultados ao canal onde foram iniciadas, e delegar tarefas limitadas e somente de leitura a subagentes. Heartbeats agendados permitem que ele revise suas notas e envie mensagens ao operador.

Uma equipe de agentes é simplesmente um conjunto de contêineres, um por agente, cada um com sua própria identidade de bot. Entre os provedores estão OpenRouter, Anthropic, OpenAI, endpoints compatíveis com OpenAI e Ollama para modelos locais.

Recursos principais

  • 01Conecta uma sessão persistente do agente ao Slack, Matrix, Telegram, Discord, IRC, Nostr e a um terminal.
  • 02Executa comandos shell longos como tarefas em segundo plano e envia os resultados ao chat de origem.
  • 03Divide e resume conversas, com recuperação semântica de mensagens anteriores.
  • 04Mantém notas e arquivos de conhecimento em um repositório git que o agente administra.
  • 05Cria subagentes paralelos com acesso somente de leitura e oferece suporte a skills e servidores MCP.
  • 06Implanta cada agente em seu próprio contêiner Docker com um volume persistente.

Casos de uso

  • Executar um assistente de operações ou monitoramento de builds que publica os resultados das tarefas em um canal do Slack.
  • Oferecer a uma equipe um agente de pesquisa compartilhado, acessível pelo Telegram ou Discord.
  • Operar um agente auto-hospedado em um homelab, usando modelos locais pelo Ollama.

Início rápido

  1. 1

    Inicie um agente no Slack com Docker, passando a chave do modelo e os tokens do bot do Slack

    docker run -d --restart=unless-stopped \ --name ops \ -v ops-home:/home/agent \ -e KERN_NAME=ops \ -e OPENROUTER_API_KEY=sk-or-... \ -e SLACK_BOT_TOKEN=xoxb-... \ -e SLACK_APP_TOKEN=xapp-... \ ghcr.io/oguzbilgic/kern-ai
  2. 2

    Envie uma mensagem para o bot; a primeira pessoa a mandar uma DM se torna a operadora

  3. 3

    Reinicie mais tarde sem variáveis de ambiente, pois a configuração fica salva no volume

    docker run -d --restart=unless-stopped -v ops-home:/home/agent ghcr.io/oguzbilgic/kern-ai

Antes de usar

  • É necessária uma chave de API de LLM (por exemplo, da OpenRouter) ou uma instalação local do Ollama para executar.
  • O README informa que a licença é MIT, mas os metadados do repositório não listam nenhuma licença. Confira o arquivo de licença antes de confiar nessa informação.

Tópicos

Perguntas frequentes

O que é kern-ai?
Um runtime de agentes de longa duração que funciona nos seus apps de chat (Slack, Matrix, Telegram, Discord, IRC, Nostr), com memória persistente e tarefas em segundo plano. kern executa um agente de IA como um processo de longa duração, com uma única memória persistente, acessível pelo Slack, Matrix, Telegram, Discord, IRC, Nostr e por uma interface de terminal. Cada agente é configurado com um nome, uma chave de provedor de modelo e uma conta de bot, e roda em seu próprio contêiner Docker, com um volume que armazena sessões, memória, notas e ferramentas instaladas.
kern-ai é gratuito? Qual é a licença?
kern-ai não declara licença. O código é público, mas sem licença você não tem permissão explícita para reutilizá-lo; fale com o autor antes de depender dele.
kern-ai ainda é mantido?
Manutenção ativa. O último commit de kern-ai foi em 8 de out. de 2026.
Para que posso usar kern-ai?
Executar um assistente de operações ou monitoramento de builds que publica os resultados das tarefas em um canal do Slack. Oferecer a uma equipe um agente de pesquisa compartilhado, acessível pelo Telegram ou Discord. Operar um agente auto-hospedado em um homelab, usando modelos locais pelo Ollama.
Como instalar kern-ai?
Inicie um agente no Slack com Docker, passando a chave do modelo e os tokens do bot do Slack: docker run -d --restart=unless-stopped \ --name ops \ -v ops-home:/home/agent \ -e KERN_NAME=ops \ -e OPENROUTER_API_KEY=sk-or-... \ -e SLACK_BOT_TOKEN=xoxb-... \ -e SLACK_APP_TOKEN=xapp-... \ ghcr.io/oguzbilgic/kern-ai Envie uma mensagem para o bot; a primeira pessoa a mandar uma DM se torna a operadora Reinicie mais tarde sem variáveis de ambiente, pois a configuração fica salva no volume: docker run -d --restart=unless-stopped -v ops-home:/home/agent ghcr.io/oguzbilgic/kern-ai
Onde consigo kern-ai?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/oguzbilgic/kern-ai

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados