Emissario
EN Pergunte à IA
Para equipes técnicas · Grátis · MIT

Instale o Emissario.

O Emissario é livre e de código aberto sob a licença MIT. É um único binário: sem runtime, sem servidor de banco de dados. A única coisa que o servidor precisa é do git.

Esta página é técnica. Ela mostra como instalar o Emissario por conta própria, com comandos no terminal de um servidor. Prefere receber tudo pronto, sem precisar de técnico? Veja a implementação.

  1. Instale o binário

    Escolha sua plataforma e cole o comando.

    macOS (Apple Silicon)
    curl -sL https://github.com/MateusMoutinhoOrg/Emissario/releases/latest/download/macarm64.bin -o emissario && chmod +x emissario && sudo mv emissario /usr/local/bin/ && emissario version
    macOS (Intel)
    curl -sL https://github.com/MateusMoutinhoOrg/Emissario/releases/latest/download/mac86.bin -o emissario && chmod +x emissario && sudo mv emissario /usr/local/bin/ && emissario version
    Linux (amd64)
    curl -sL https://github.com/MateusMoutinhoOrg/Emissario/releases/latest/download/linux86.out -o emissario && chmod +x emissario && sudo mv emissario /usr/local/bin/ && emissario version
    Linux (arm64)
    curl -sL https://github.com/MateusMoutinhoOrg/Emissario/releases/latest/download/linuxarm64.out -o emissario && chmod +x emissario && sudo mv emissario /usr/local/bin/ && emissario version
    Linux (32 bits)
    curl -sL https://github.com/MateusMoutinhoOrg/Emissario/releases/latest/download/linuxi32.out -o emissario && chmod +x emissario && sudo mv emissario /usr/local/bin/ && emissario version
    Windows (64 bits) — PowerShell
    $dir="$HOME\.local\bin"; New-Item -ItemType Directory -Force -Path $dir | Out-Null; curl.exe -sL https://github.com/MateusMoutinhoOrg/Emissario/releases/latest/download/windows86.exe -o "$dir\emissario.exe"; [Environment]::SetEnvironmentVariable('PATH', [Environment]::GetEnvironmentVariable('PATH','User') + ";$dir", 'User')
    Windows (32 bits) — PowerShell
    $dir="$HOME\.local\bin"; New-Item -ItemType Directory -Force -Path $dir | Out-Null; curl.exe -sL https://github.com/MateusMoutinhoOrg/Emissario/releases/latest/download/windowsi32.exe -o "$dir\emissario.exe"; [Environment]::SetEnvironmentVariable('PATH', [Environment]::GetEnvironmentVariable('PATH','User') + ";$dir", 'User')
    A partir do código — precisa de Go 1.25+
    go build -o emissario ./cmd/main && sudo mv emissario /usr/local/bin/ && emissario version

    Fonte: CliInstall. emissario help lista todos os comandos.

  2. Inicie

    O início rápido do README:

    $ export EMISSARIO_ENCRYPT_KEY=$(emissario generate-encrypt-key)   # guarde em lugar seguro: perder a chave perde todos os bancos e backups
$ emissario add-backoffice-user --username admin --email admin@example.com --role root   # mostra a senha uma única vez
$ emissario start-server --insecure-http --addr 127.0.0.1:3000                            # http simples, só local

    Abra http://127.0.0.1:3000/admin/login e entre.

    Em produção, tire o --insecure-http, sirva por https e defina EMISSARIO_BACKOFFICE_SECRET para que as sessões sobrevivam a um reinício. Todo comando que abre um banco precisa de EMISSARIO_ENCRYPT_KEY; --notencrypt deixa os dados sem criptografia, só para depuração local.

  3. Configure pelo backoffice

    Com um usuário root:

    • Fonte do site: o repositório, a branch e o intervalo de sincronização do seu site.
    • Privacidade: um preset — lgpd@1, gdpr@1 ou lgpd-gdpr@1 — ou cada valor.
    • Agente: o repositório de instruções, o modelo e os limites de tokens — depois ligue.
    • Dois fatores: proteja a sua conta com um app autenticador.

  4. Construa o seu site

    O Emissario serve a pasta frontend/ do seu repositório, como está no commit. Deixe um agente de código conhecer as rotas que suas páginas podem chamar e os arquivos que o seu agente lê:

    $ emissario drop-front-skills  --path ../my-site    # no repositório do site
$ emissario drop-agents-skills --path ../my-agent   # no repositório de instruções do agente
Documentação

Cada funcionalidade está documentada.

O índice completo fica no README do repositório. Abrir o índice

Commands

Todos os comandos da CLI.

Ler

WebsiteSource

Servir o site a partir de um repositório git.

Ler

Agent

O chat público com IA, seus limites e resumos.

Ler

Backoffice

Usuários, papéis, sessões e tokens de API.

Ler

Privacy

Criptografia, IPs, retenções, LGPD e GDPR.

Ler

ContactRequests

O formulário de contato do site.

Ler

Visualization

Visualizações, registradas no servidor.

Ler

Backups

Fazer, baixar e restaurar snapshots.

Ler

Prefere que façam para você? Mateus Moutinho, criador do Emissario, pode configurá-lo no seu servidor. Veja o preço →