Sistema e implantação

Sistema operacional
  • Linux, em servidor físico ou máquina virtual
  • Arquiteturas x86_64 e ARM64

Windows não é suportado. macOS apenas para desenvolvimento.

Contêineres2
  • Docker Engine com Compose v2 (instalação guiada)
  • Podman, com suporte parcial e sem instalação guiada
Serviços

Dez serviços em contêineres: proxy, web, API, worker, PostgreSQL, Redis, armazenamento de objetos compatível com S3, Milvus, etcd e um guardião isolado para o Docker.

Dependências externas

PostgreSQL, Redis, armazenamento compatível com S3 e Milvus ou Zilliz podem ser os da própria instalação ou serviços já existentes na sua organização.

Topologia

Um nó por instalação. Várias instalações isoladas podem conviver no mesmo servidor, cada uma com seus contêineres e sua rede.

Rede
  • Proxy HTTP em uma porta, 8080 por padrão
  • TLS terminado no balanceador ou no proxy reverso da sua organização
  • Compatível com proxies corporativos e inspeção TLS, com a CA da organização instalada no servidor
Modos de operação3
  • Online
  • Totalmente offline, em rede isolada, com licença por arquivo
Interface
  • 9 idiomas, com tradução mais completa em português, inglês e espanhol
  • Temas claro e escuro
  • Logo, nome e cor da sua organização na tela de entrada e no menu

Hardware e aceleração

Memória4
  • Mínimo: 4 GiB
  • Recomendado: 8 GiB
Disco
  • Mínimo: 10 GiB
  • Recomendado: 50 GiB
CPU

Executa a plataforma e os modelos locais somente com CPU, em x86_64 ou ARM64. A verificação da máquina indica o maior modelo do catálogo que cabe nela.

GPU
  • NVIDIA, via CUDA, com o driver e o NVIDIA Container Toolkit
  • Intel integradas ou dedicadas, via OpenVINO

Sem o NVIDIA Container Toolkit, a plataforma sobe na CPU em vez de falhar.

NPU

Inferência em NPU.

Detecção

O painel do sistema mostra CPU, memória, discos e GPUs (NVIDIA, AMD, Intel e Apple), com a memória de vídeo.

Verificação de compatibilidade

Antes de implantar um modelo, a plataforma confere o runtime, o hardware e a memória disponível e recusa combinações incompatíveis.

Modelos e runtimes

Provedores em nuvem

OpenAI, Azure OpenAI, Anthropic e qualquer endpoint compatível com a API da OpenAI.

Chaves cifradas e teste de conexão.

Runtimes locais gerenciados

vLLM, llama.cpp, OpenVINO Model Server, TensorRT-LLM, SGLang e IPEX-LLM, em contêineres isolados, com instalação, início, parada, reinício e remoção pelo painel.

IPEX-LLM ainda em validação.

Servidores locais existentes

Ollama, vLLM e LM Studio em execução são detectados e conectados como endpoints compatíveis.

Catálogo

Mais de 1.000 modelos abertos, em um catálogo curado filtrável por modalidade, família, quantização e runtime, com estimativa de compatibilidade com a máquina.

Formatos de pesos
  • GGUF
  • OpenVINO IR
  • safetensors (Hugging Face)

Cada formato é oferecido apenas aos runtimes que o executam.

Quantizações

Q4_K_M, Q5_K_M, Q8_0, FP16, INT8 e INT4

Habilitação

Modelos globais, habilitados por workspace, com modelos padrão para embeddings, reclassificação, visão e transcrição.

Agentes

Modelo base local ou em nuvem, instruções de sistema, temperatura, máximo de tokens, penalidade de repetição, top-p e top-k. Rascunho, publicado ou arquivado, com acesso por workspace e por pessoa.

Dados e formatos

Contextos de conhecimento5
  • 41 extensões de arquivo
  • Texto: txt, md, csv, tsv, json, xml, html e log
  • PDF e Office: pdf, docx, xlsx e pptx
  • Imagens, em 10 extensões, descritas por um modelo de visão
  • Áudio, em 9 extensões, e vídeo, em 8, transcritos
Busca

Híbrida: vetorial (Milvus) e textual (PostgreSQL), combinadas por Reciprocal Rank Fusion e reordenadas por um modelo de reclassificação.

Trechos de 900 caracteres, com 150 de sobreposição.

Embeddings

Servidos localmente por modelos compatíveis com a API da OpenAI. Cada contexto fixa o seu modelo e pode ser reindexado.

Contextos de dados
  • Tipos: texto, inteiro, decimal, booleano, data, data e hora e JSON
  • Chave primária, colunas pesquisáveis e rótulos de sensibilidade
  • Carga de CSV, TSV ou XLSX até 100 MB, em acréscimo ou substituição, com as linhas rejeitadas e o motivo
Consultas SQL

Somente leitura, em um papel de banco separado: uma instrução SELECT por vez, com tempo limite e até 1.000 linhas. Podem ser desligadas por contexto.

Anexos no chat

Documentos, imagens, áudio e vídeo, até 100 MB por arquivo, com tipos e limites definidos pelo administrador.

Arquivos gerados

.xlsx, .pptx, .pdf, .csv, .md e .txt

Busca na web

Opcional, por mensagem: DuckDuckGo (padrão), Tavily ou Brave.

Entrada por voz

Reconhecimento de fala do navegador ou um modelo de transcrição.

Fluxos

Editor

Visual, com 13 tipos de bloco: Entrada, Decisão, Agente, Modelo de IA, Integração, Busca no armazenamento, Consulta de dados, Gravar dados, IA sobre linhas, Carregar arquivos, Transformar, Subfluxo e Saída.

Saída estruturada

JSON Schema com enumerações fechadas e nível de raciocínio configurável nos blocos de IA.

IA sobre linhas

Até 50 linhas por chamada e até 8 chamadas simultâneas.

Subfluxos

Até 8 níveis de aninhamento.

Ciclo de vida

Rascunho, publicado e arquivado, com contrato de entrada e de saída em JSON Schema.

Execução
  • Pelo chat
  • Por endpoint HTTP, com token próprio de cada fluxo
  • Por agendamento em intervalos a partir de 60 segundos, com entrada fixa, início e número máximo de execuções
Rastro

Cada execução registra a entrada, as fontes consultadas com a relevância, as decisões e a saída de cada etapa.

Templates de fluxo

30, em 6 áreas: crédito e risco (8), documentos e back-office (7), atendimento (5), compliance e jurídico (4), RH (3) e vendas (3).

Portabilidade

Exportação e importação de fluxos em JSON.

Integrações

Conectores prontos6
  • Mais de 99. Exemplos por categoria:
  • E-commerce: Amazon Selling Partner, Mercado Livre, Shopify, Meta Product Catalog e TikTok Shop
  • Mensageria: WhatsApp Cloud API, Telegram, Twilio e Slack
  • Produtividade: Microsoft 365 e Google Workspace
  • ERP: TOTVS Protheus
  • CRM: Salesforce
  • Banco de dados: SAP HANA
  • DevOps: Jira e Confluence
  • ITOM: HPE OpsRamp
  • Backup: Veeam
  • Segurança: Netskope
  • Dados de mercado: AwesomeAPI
Conexões personalizadas
  • REST e GraphQL, executadas nos fluxos
  • Outros tipos, como banco de dados, transferência de arquivos e gRPC, ficam cadastrados com teste de conectividade
Autenticação

Chave de API, bearer, básica, OAuth 2.0 client credentials e OAuth 2.0 refresh token, com renovação automática, além da opção sem autenticação.

Credenciais cifradas e decifradas apenas na execução.

API de fluxos

Endpoint HTTP (POST) por fluxo publicado, com token bearer próprio, exibido uma única vez, guardado como hash e rotacionável, e lista de origens permitidas (CORS).

Proteção

Chamadas de saída validadas contra SSRF e sem seguir redirecionamentos.

Identidade e acesso

SSO

OIDC (Authorization Code com PKCE) com Microsoft Entra ID, Google Workspace ou qualquer provedor OIDC, como Keycloak, Okta e Auth0.

MFA pelo provedor de identidade. Política opcional de acesso somente por SSO.

Regras por grupo

Grupos do diretório concedem administração, módulos e workspaces.

Papéis

Proprietário (root), administrador e membro.

Módulos

Concedidos por pessoa: Chat, Agentes, Armazenamento, Dados, Fluxos, Agendamentos e Integrações. Novos usuários começam sem nenhum.

Workspaces

Um espaço pessoal para cada usuário e espaços compartilhados, com membros, modelos e agentes habilitados por espaço.

Login local
  • Senhas com no mínimo 12 caracteres, com hash Argon2
  • Cookies de sessão HttpOnly e SameSite=Strict
Bloqueio

Após 7 falhas por origem ou 30 por conta, por 15 minutos.

Conta de emergência

Conta root com senha, nunca federada, recuperável no servidor com uma chave de uso único verificada offline.

Governança e auditoria

Trilha de auditoria

Logins e falhas, usuários e workspaces, SSO e política de acesso, provedores e segredos, licença, conta root, consultas e cargas de dados, configurações com valores antes e depois e cada exclusão.

Não entra no expurgo automático e não pode ser editada nem excluída pela API.

Registro de interações

Cada interação de chat, agente e fluxo, com conteúdo, modelo, workspace, usuário, tokens, latência e avaliação, com filtros.

Proveniência

Modelo e fontes de cada resposta: documentos com a relevância, ou a consulta SQL com o número de linhas. Indicadores de respostas com fontes e de documentos indexados.

Qualidade de dados7

Registro de irregularidades com plano de ação, relatório semestral e dicionário de dados legível por máquina, alinhados à Resolução Conjunta CMN/BCB nº 18/2025.

Retenção

Opcional: expurgo de execuções de fluxo, mensagens e cargas de dados após o prazo definido. Sem política, os dados são mantidos. Cada exclusão fica registrada.

Uso

Conversas, mensagens, tokens de entrada e de saída e avaliações, no total e por pessoa.

Observabilidade

Logs estruturados em JSON, verificações /health e /ready e exportação de rastros e logs via OpenTelemetry (OTLP) para o coletor da sua organização.

Segredos

XChaCha20-Poly1305 para chaves e credenciais. Cada instalação gera os próprios segredos e senhas de serviço.

Isolamento do Docker

A API não tem acesso direto ao Docker do servidor. Um guardião isolado e sem rede permite apenas operações dos runtimes de modelo, sem contêineres privilegiados, montagens do servidor ou rede do host.

Operação e CLI

CLI

Binário estático para Linux x86_64 e ARM64, inclusive RHEL 8, Ubuntu 20.04 e Debian 11, em português e inglês.

Verificação

aptabit check: sistema, memória, disco, Docker e Compose, GPUs e NPUs, rede, relógio e proxy, com saída em JSON e modo offline.

Instalação

aptabit install: verifica, configura e sobe a plataforma. Executar de novo atualiza a instalação existente e nunca apaga dados.

Atualização

aptabit update: backup prévio, atualização em etapas com verificação de saúde e reversão automática se a nova versão falhar. Canais e fixação de versão.

Backup

Cópias locais da configuração e dos volumes da instalação, com listagem, reversão e limpeza.

A plataforma para por alguns instantes durante a cópia. Serviços externos não entram no backup.

Diagnóstico

Status em JSON, diagnóstico e pacote de suporte sem senhas, chaves ou tokens. Cada erro tem um código estável.

Migrações

Aplicadas automaticamente ao iniciar a plataforma.

Imagens

Registro privado com credenciais de curta duração vinculadas à licença e declaração de proveniência assinada em cada imagem do produto.

Licenciamento

Cobrança
  • Apenas pelos fluxos publicados em produção
  • Sem cobrança por usuário, por token, por armazenamento ou por uso
Licença

Por cliente, assinada digitalmente (Ed25519), com um par de chaves gerado em cada instalação.

Modo online

Verificação pelo menos a cada 6 horas. Sem contato, a plataforma segue funcionando por até 7 dias, prazo padrão definido em cada licença.

Modo offline

Arquivo de licença válido por até 120 dias, renovado da mesma forma. A instalação nunca contata a Aptabit.

Dados enviados no modo online

Metadados da licença e da instalação. Conforme o nível de telemetria definido na licença, também contagens agregadas de uso, relatórios de falha do CLI sem senhas, chaves ou tokens e, no nível completo, um inventário do hardware e do ambiente. Nenhum documento, conversa, prompt ou arquivo.

Vencimento

Carência de 7 dias por padrão. Uma licença vencida ou suspensa bloqueia o acesso, mas nunca apaga dados nem contêineres.

Precisa de mais detalhes técnicos?

Fale com a nossa equipe para planejar a instalação no seu ambiente.

Notas

  1. Especificações da versão 3.7.1. Podem mudar em versões futuras.
  2. O instalador guiado usa Docker Engine com Compose v2. O suporte a Podman é parcial.
  3. Em instalações isoladas, as imagens dos runtimes e os pesos dos modelos locais são transferidos à parte, ou o modelo é servido por um servidor de inferência compatível na rede local.
  4. Requisitos da plataforma. Cada modelo local acrescenta de 1 a 40 GB de memória e de disco, conforme o tamanho.
  5. PDFs digitalizados sem camada de texto não passam por OCR. Arquivos .doc, .xls e .ppt são aceitos, mas o texto deles não é extraído.
  6. Os fluxos executam chamadas HTTP (REST e GraphQL). Conexões de outros tipos, inclusive o conector de SAP HANA, oferecem cadastro e teste de conectividade.
  7. Recursos de apoio à conformidade. Não constituem certificação.

© 2026 NVIDIA, the NVIDIA logo, CUDA, and TensorRT are trademarks and/or registered trademarks of NVIDIA Corporation in the U.S. and other countries.