Instale e opere o bot de Discord que grava calls, transcreve cada pessoa e gera atas, decisões e tarefas.
O caminho mínimo entre um servidor novo e a primeira call gravada.
git clone https://github.com/resolvicomai/kassinao.git
cd kassinao
cp .env.example .env && chmod 600 .env
mkdir -p recordings && chmod 700 recordingsDISCORD_TOKEN=cole_o_token_do_bot
APPLICATION_ID=cole_o_id_da_aplicacao
DISCORD_CLIENT_SECRET=cole_o_client_secret
APP_URL=https://kassinao.seu-dominio.comdocker compose up -d --build
docker compose logs -fTranscrição e ata são opcionais. Configure um provider depois de validar a gravação, o login e os downloads.
O Kassinão é um bot persistente de voz. Ele precisa ficar conectado ao Discord.
Vercel e Netlify não mantêm o gateway de voz WebSocket ativo. Use Docker numa máquina persistente.
Configure primeiro o Discord, depois a URL pública e só então suba o container.
No Discord Developer Portal, crie uma aplicação. Copie o Application ID, gere o token do bot e copie o Client Secret em OAuth2.
Cadastre exatamente APP_URL/auth/callback em OAuth2 Redirects.
Use os scopes bot e applications.commands. O número de permissões usado pelo projeto é 68242432.
https://discord.com/oauth2/authorize?client_id=SEU_APP_ID&scope=bot%20applications.commands&permissions=68242432Permissões: Ver Canais, Enviar Mensagens, Inserir Links, Ler Histórico, Conectar e Alterar Apelido.
Com Cloudflare Tunnel, aponte o hostname público para kassinao:8080. Defina TUNNEL_TOKEN e COMPOSE_PROFILES=tunnel.
IP direto serve apenas para teste. O OAuth do Discord aceita HTTP somente em localhost.
Suba o compose, acompanhe o log e abra /health. As gravações ficam no volume ./recordings.
docker compose up -d --build
docker compose logs -fComece pelo bloco obrigatório. Abra os grupos seguintes apenas quando precisar da função.
O .env já é ignorado. Gere COOKIE_SECRET e MCP_SECRET com openssl rand -hex 32 e nunca use o mesmo valor nos dois.
O Discord mostra automaticamente o nome em português ou inglês conforme o idioma do cliente.
/gravar [canal]
Entra no seu canal de voz e começa uma gravação com uma faixa separada por pessoa. Admins podem indicar outro canal visível.
/parar
Encerra a gravação, libera o link privado e inicia a fila de transcrição e ata.
/nota <texto>
Salva uma nota no segundo atual. O painel também oferece ações para marcar um momento ou escrever uma nota.
/status
Mostra o estado da gravação em andamento que você tem permissão para acompanhar.
/gravacoes
Lista gravações acessíveis e abre a central privada com busca em transcrições, atas e notas.
/perguntar <pergunta> [dias]
Busca por tema, pessoa, data da call ou prazo e responde só para você com evidências e links para o segundo exato.
/autorecord ligar|desligar|ver
Configura a gravação automática por canal e o mínimo de pessoas para iniciar.
/config ata-canal|ver
Escolhe o canal do aviso genérico de processamento ou consulta a configuração atual. Detalhes e links ficam nas DMs autorizadas.
/mcp novo|revogar-tudo
Gera um código de conexão ou revoga conectores. Só aparece quando o MCP está habilitado. Membros comuns usam a página de conexão.
/ajuda
Abre o guia interativo do bot com gravação, downloads, perguntas, privacidade e auto-record.
/sobre
Mostra autor, licença AGPL-3.0 e código-fonte.
É ali que o bot consegue validar servidor, canal e permissões. As respostas de /perguntar são efêmeras e só aparecem para quem perguntou.
Do comando no canal de voz até a central privada.
O bot entra no canal, publica o painel e usa o prefixo [GRAVANDO] no apelido. A captura só começa depois do aviso.
Os pacotes Opus são decodificados para PCM e um ffmpeg por pessoa grava FLAC contínuo e sincronizado. Não há diarização para adivinhar o falante.
Use /nota ou os botões do painel. As marcações entram na página, na transcrição e nos labels do Audacity.
Use /parar. O bot também encerra quando o canal esvazia, passa do limite ou é desconectado. Silêncio prolongado gera aviso, não parada.
O mix pré-processado alimenta o player imediatamente. MP3, FLAC, mix e projeto do Audacity são gerados sob demanda e ficam em cache.
O VAD normalmente envia só os trechos com fala; se a detecção falhar, usa blocos fixos para não perder a call. Depois, a ata gera resumo, decisões e tarefas.
A gravação funciona sem IA. Quando ativada, a IA entra depois da call e nunca decide quem falou.
Construa a imagem com LOCAL_TRANSCRIBE=1 e use o wrapper incluído. O comando precisa escrever em {output} um array JSON com start, end e text.
TRANSCRIBE_PROVIDER=command
TRANSCRIBE_COMMAND=python3 ./scripts/transcribe-local.py {input} {output}
WHISPER_MODEL=smalldocker compose build --build-arg LOCAL_TRANSCRIBE=1
docker compose up -dVoz é dado pessoal. O controle de acesso é aplicado no servidor em toda abertura, busca e conexão.
O bot entra no canal, publica um painel e muda o apelido para [GRAVANDO] antes de capturar áudio.
A página exige OAuth do Discord e participação atual no servidor. Sair do servidor encerra o acesso.
Em qualquer canal, só abre para quem estava na call, mesmo mutado, quem iniciou ou um admin atual. Receber permissão depois não libera o passado.
Se o Discord não consegue confirmar o acesso, a página nega. A API do MCP devolve erro temporário quando a checagem está indisponível.
O áudio pode expirar antes da transcrição, ata e notas. O operador também pode apagar somente o áudio ou apagar tudo.
Cookies e MCP usam segredos diferentes. Girar MCP_SECRET revoga todos os conectores sem invalidar a regra de acesso.
Troque DISCORD_TOKEN, DISCORD_CLIENT_SECRET, TUNNEL_TOKEN e chaves de API. Problemas de segurança devem ser reportados em privado.
Leve a memória das reuniões para Claude, Cursor ou outro cliente MCP sem copiar o acervo para a máquina.
Ele não entrega áudio, não apaga gravações e não amplia permissões. Cada chamada passa pela mesma checagem da web.
Defina um MCP_SECRET dedicado com no mínimo 32 bytes e reinicie. A página /app/conectar-ia e a API só existem quando esse segredo está presente.
openssl rand -hex 32Abra /app/conectar-ia, entre com Discord e gere uma conexão nomeada. Copie o código descartável e execute o comando exibido: ele pede o código com a entrada oculta, salva o token em um arquivo local protegido (0600 no macOS/Linux; ACL herdada do perfil no Windows) e imprime uma configuração sem segredo. O computador precisa de Node.js 20 ou superior.
{
"mcpServers": {
"kassinao": {
"command": "npx",
"args": ["-y", "kassinao-mcp@1.0.5"],
"env": {
"KASSINAO_URL": "https://SEU-KASSINAO",
"KASSINAO_PROFILE": "PERFIL_IMPRESSO_PELO_COMANDO"
}
}
}
}O mesmo fluxo funciona sem navegador: um ID presente em OWNER_IDS gera um código com /mcp novo e faz a troca pelo terminal.
npx -y kassinao-mcp@1.0.5 exchange --stdin --url https://SEU-KASSINAOlist_meetingsLista reuniões num período.
pending_actionsCruza pendências e prazos.
search_meetingsBusca em transcrições, atas e notas.
who_saidEncontra o que uma pessoa disse sobre um tema.
get_meetingAbre o dossiê completo de uma reunião.
O refresh token fica em ~/.config/kassinao-mcp, protegido por modo 0600 no macOS/Linux e pelas ACLs herdadas do perfil no Windows, e gira a cada renovação. Revogue uma conexão na página, use /mcp revogar-tudo ou gire MCP_SECRET para revogar todos.
Comece sempre por docker compose logs -f. O bot valida a configuração no boot e explica as variáveis inválidas.
Confirme DISCORD_TOKEN, APPLICATION_ID e DISCORD_CLIENT_SECRET. Verifique também se APP_URL é uma origem HTTP ou HTTPS sem caminho, query ou hash.
docker compose logs --tail=200 kassinao
Confirme que o convite incluiu applications.commands e que o bot já está no servidor. Reinicie o bot. Se GUILD_ID estiver definido, os comandos só são registrados naquele servidor.
Cadastre exatamente APP_URL/auth/callback em OAuth2 Redirects. Em produção, APP_URL precisa usar HTTPS. Depois de mudar a origem, atualize o redirect e reinicie.
O serviço fica num profile. Defina COMPOSE_PROFILES=tunnel ou execute docker compose --profile tunnel up -d. No painel da Cloudflare, o destino interno é kassinao:8080.
Confirme que TRANSCRIBE_PROVIDER não está como none e que a chave do provider existe. Consulte o log da fila. A gravação e os downloads continuam válidos mesmo sem IA.
Com MINUTES_ENABLED=auto, a ata só liga quando OPENROUTER_API_KEY ou GROQ_API_KEY está definida. Confirme também MINUTES_PROVIDER e o limite do provider em calls longas.
Isso é esperado quando MCP_SECRET está vazio. Gere um segredo dedicado com 32 bytes ou mais, diferente de COOKIE_SECRET, e reinicie o bot.
Confirme que ela continua no servidor. Em qualquer canal, ela precisa ter estado na call, ter iniciado a gravação ou ser admin atual. Ganhar acesso ao canal depois não libera o histórico.
Libere espaço no host ou ajuste MIN_FREE_MB_START e MIN_FREE_MB_ABORT com cuidado. O limite de abortar não pode ser maior que o limite de iniciar.
É o comportamento da retenção em camadas. RETENTION_DAYS controla o áudio e TEXT_RETENTION_DAYS controla transcrição, ata e notas. Use zero para não expirar automaticamente.
Código, MCP, configuração e canais corretos para suporte.
Tente um comando como gravar, uma variável como APP_URL ou um tema como privacidade.