Corgi: assistente executivo pessoal self-hosted (pt-BR). Derivado do OpenMuse da CopilotKit.
TypeScript
1
3 commits
updated Sep 25, 2026
Um assistente executivo pessoal que você hospeda: conversa, usa seus apps, navega por você e continua o trabalho em segundo plano. Em português, do celular ou do computador.
A self-hosted personal executive assistant, Brazilian Portuguese first. Each person runs their own server with their own keys. Free for noncommercial use.
 Sua agenda, direto no chat |  Pesquisa e recomenda |  Trabalho em segundo plano |
 Ajudantes com missão própria |  O Radar avisa só o que importa |  Memória que aprende seu jeito |
Telas reais do app, com uma pessoa e dados fictícios.
Derivado do OpenMuse, criado pela CopilotKit sob licença MIT. O Corgi começou como um fork do OpenMuse e evoluiu de forma independente. Obrigado à equipe e aos contribuidores do OpenMuse: a base de chat nativo, o navegador do agente, as revisões de ações e as tarefas duráveis vêm de lá. Veja Créditos.
| Chat | Respostas com elementos visuais (agenda, tabelas, números, cartões, clima, rotas), fila de mensagens, voz, fotos e arquivos, conversas paralelas. |
| Seus apps | Gmail, Agenda, Slack, Notion, Drive e muitos outros via Composio, cada um com a sua permissão (pede aprovação / só ler / desligado). Apify com a sua própria chave. |
| Navegador próprio | Um Chromium com perfil persistente e uma aba por conversa: busca, filtra, preenche; o login é sempre seu (ele nunca digita senhas) e a compra para antes do botão final. |
| Trabalho em segundo plano | Tarefas com checklist e anotações que continuam com o app fechado, pausam para sua resposta ou aprovação e sobrevivem a reinícios. Rotinas (semanal, quinzenal, mensal, trimestral), alertas de página e metas. |
| Ajudantes | Pequenos assistentes com uma missão (Radar do Slack, Preparador de reuniões, Concorrentes…), conversa própria e só os apps que você liberar. O Corgi chama; você conversa com eles. |
| Memória | Lembra com a origem de cada fato, revisa as conversas de hora em hora, reflete toda noite e esquece de verdade quando você pede. |
| Segurança | Toda mudança fora do app (enviar, marcar, alterar, comprar) vira um cartão de aprovação. Um guarda (Jev) checa e-mails e páginas contra phishing e injeção de instruções. |
| No celular | Web app na tela de início com notificações (Web Push) para aprovações, perguntas e resultados. |
Precisa de Node 24 e pnpm 11.
git clone <este repositório> corgi && cd corgi
pnpm install --frozen-lockfile
pnpm corgi:setup # cria o .env, gera as chaves secretas e pede as suas
pnpm dev # API em http://localhost:8787
pnpm dev:browser # o navegador do assistente (outro terminal)
pnpm dev:web # o app em http://localhost:8081 (outro terminal)
Na primeira vez, o navegador do assistente precisa do Chromium:
pnpm --dir apps/worker exec playwright install chromium.
| Chave | Para quê | Obrigatória |
|---|---|---|
IMPOSSIBL_API_KEY | Os modelos do assistente (chat, tarefas, navegador, guarda de segurança). Impossibl | Sim |
OPENMUSE_ACCESS_KEY, TOKEN_ENCRYPTION_KEY, WORKER_TOKEN | Acesso ao app, criptografia das credenciais, token do navegador. Geradas pelo corgi:setup. | Sim (automáticas) |
COMPOSIO_API_KEY | Conectar Gmail, Agenda, Slack, Notion… Composio | Opcional |
| Token do Apify | Coletores prontos de dados públicos. Informado no app (Ajustes › Apps › Apify). | Opcional |
Todas as opções estão comentadas no .env.example. Ao iniciar, o servidor avisa o que ainda falta configurar.
Uma VPS pequena (ou um Mac mini) com Tailscale deixa o Corgi acessível só para os seus aparelhos, com HTTPS. O passo a passo, com scripts de instalação e atualização, está em docs/DEPLOY.md. No iPhone, abra o endereço no Safari e use "Adicionar à Tela de Início".
flowchart TD
App[App Expo: iOS, Android, web] -->|AG-UI + API| API[API Hono + motor de chat]
API --> Store[(PGlite ou Postgres)]
API --> Tasks[Tarefas duráveis]
API --> Apps[Apps: Composio · Apify]
API --> Browser[Navegador: Playwright]
API --> Models[Impossibl: Muse, GLM, Jev]
Tasks --> Approvals[Ações revisadas]
O código é organizado por domínio, e cada pasta importante tem um AGENTS.md com as regras dela;
comece pelo AGENTS.md da raiz. Toda a documentação: docs/README.md.
pnpm lint && pnpm typecheck && pnpm test # os testes usam só dados locais: sem rede, sem contas reais
Cada instalação é de uma pessoa. Suas conversas, memórias, arquivos e credenciais ficam no seu
servidor (.openmuse/); as chaves ficam no seu .env, que nunca vai para o git. O Corgi envia o
necessário para os provedores que você configurar (modelos, apps), e nada para os autores deste
projeto.
Não aceitamos pull requests. O Corgi é compartilhado como uma contribuição, no estado em que se encontra: não há intenção de oferecer suporte, correções ou melhorias, que só acontecem por nossa própria liberalidade. Fique à vontade para adaptar no seu fork, dentro da licença. Veja CONTRIBUTING.md.
Uso não comercial. O Corgi é licenciado sob a PolyForm Noncommercial 1.0.0: você pode usar, estudar, modificar e compartilhar para fins pessoais e não comerciais (e organizações sem fins lucrativos, pesquisa e educação). Uso comercial não é permitido. Veja LICENSE.
As partes que vêm do OpenMuse continuam disponíveis sob a licença MIT original, com o aviso de copyright dos seus autores: LICENSE-OPENMUSE.
Corgi: assistente executivo pessoal self-hosted (pt-BR). Derivado do OpenMuse da CopilotKit.
TypeScript
1
3 commits
updated Sep 25, 2026
Um assistente executivo pessoal que você hospeda: conversa, usa seus apps, navega por você e continua o trabalho em segundo plano. Em português, do celular ou do computador.
A self-hosted personal executive assistant, Brazilian Portuguese first. Each person runs their own server with their own keys. Free for noncommercial use.
Sua agenda, direto no chat | Pesquisa e recomenda | Trabalho em segundo plano |
Ajudantes com missão própria | O Radar avisa só o que importa | Memória que aprende seu jeito |
Telas reais do app, com uma pessoa e dados fictícios.
Derivado do OpenMuse, criado pela CopilotKit sob licença MIT. O Corgi começou como um fork do OpenMuse e evoluiu de forma independente. Obrigado à equipe e aos contribuidores do OpenMuse: a base de chat nativo, o navegador do agente, as revisões de ações e as tarefas duráveis vêm de lá. Veja Créditos.
| Chat | Respostas com elementos visuais (agenda, tabelas, números, cartões, clima, rotas), fila de mensagens, voz, fotos e arquivos, conversas paralelas. |
| Seus apps | Gmail, Agenda, Slack, Notion, Drive e muitos outros via Composio, cada um com a sua permissão (pede aprovação / só ler / desligado). Apify com a sua própria chave. |
| Navegador próprio | Um Chromium com perfil persistente e uma aba por conversa: busca, filtra, preenche; o login é sempre seu (ele nunca digita senhas) e a compra para antes do botão final. |
| Trabalho em segundo plano | Tarefas com checklist e anotações que continuam com o app fechado, pausam para sua resposta ou aprovação e sobrevivem a reinícios. Rotinas (semanal, quinzenal, mensal, trimestral), alertas de página e metas. |
| Ajudantes | Pequenos assistentes com uma missão (Radar do Slack, Preparador de reuniões, Concorrentes…), conversa própria e só os apps que você liberar. O Corgi chama; você conversa com eles. |
| Memória | Lembra com a origem de cada fato, revisa as conversas de hora em hora, reflete toda noite e esquece de verdade quando você pede. |
| Segurança | Toda mudança fora do app (enviar, marcar, alterar, comprar) vira um cartão de aprovação. Um guarda (Jev) checa e-mails e páginas contra phishing e injeção de instruções. |
| No celular | Web app na tela de início com notificações (Web Push) para aprovações, perguntas e resultados. |
Precisa de Node 24 e pnpm 11.
git clone <este repositório> corgi && cd corgi
pnpm install --frozen-lockfile
pnpm corgi:setup # cria o .env, gera as chaves secretas e pede as suas
pnpm dev # API em http://localhost:8787
pnpm dev:browser # o navegador do assistente (outro terminal)
pnpm dev:web # o app em http://localhost:8081 (outro terminal)
Na primeira vez, o navegador do assistente precisa do Chromium:
pnpm --dir apps/worker exec playwright install chromium.
| Chave | Para quê | Obrigatória |
|---|---|---|
IMPOSSIBL_API_KEY | Os modelos do assistente (chat, tarefas, navegador, guarda de segurança). Impossibl | Sim |
OPENMUSE_ACCESS_KEY, TOKEN_ENCRYPTION_KEY, WORKER_TOKEN | Acesso ao app, criptografia das credenciais, token do navegador. Geradas pelo corgi:setup. | Sim (automáticas) |
COMPOSIO_API_KEY | Conectar Gmail, Agenda, Slack, Notion… Composio | Opcional |
| Token do Apify | Coletores prontos de dados públicos. Informado no app (Ajustes › Apps › Apify). | Opcional |
Todas as opções estão comentadas no .env.example. Ao iniciar, o servidor avisa o que ainda falta configurar.
Uma VPS pequena (ou um Mac mini) com Tailscale deixa o Corgi acessível só para os seus aparelhos, com HTTPS. O passo a passo, com scripts de instalação e atualização, está em docs/DEPLOY.md. No iPhone, abra o endereço no Safari e use "Adicionar à Tela de Início".
flowchart TD
App[App Expo: iOS, Android, web] -->|AG-UI + API| API[API Hono + motor de chat]
API --> Store[(PGlite ou Postgres)]
API --> Tasks[Tarefas duráveis]
API --> Apps[Apps: Composio · Apify]
API --> Browser[Navegador: Playwright]
API --> Models[Impossibl: Muse, GLM, Jev]
Tasks --> Approvals[Ações revisadas]
O código é organizado por domínio, e cada pasta importante tem um AGENTS.md com as regras dela;
comece pelo AGENTS.md da raiz. Toda a documentação: docs/README.md.
pnpm lint && pnpm typecheck && pnpm test # os testes usam só dados locais: sem rede, sem contas reais
Cada instalação é de uma pessoa. Suas conversas, memórias, arquivos e credenciais ficam no seu
servidor (.openmuse/); as chaves ficam no seu .env, que nunca vai para o git. O Corgi envia o
necessário para os provedores que você configurar (modelos, apps), e nada para os autores deste
projeto.
Não aceitamos pull requests. O Corgi é compartilhado como uma contribuição, no estado em que se encontra: não há intenção de oferecer suporte, correções ou melhorias, que só acontecem por nossa própria liberalidade. Fique à vontade para adaptar no seu fork, dentro da licença. Veja CONTRIBUTING.md.
Uso não comercial. O Corgi é licenciado sob a PolyForm Noncommercial 1.0.0: você pode usar, estudar, modificar e compartilhar para fins pessoais e não comerciais (e organizações sem fins lucrativos, pesquisa e educação). Uso comercial não é permitido. Veja LICENSE.
As partes que vêm do OpenMuse continuam disponíveis sob a licença MIT original, com o aviso de copyright dos seus autores: LICENSE-OPENMUSE.