Argus

Capacidades

Recursos documentados no Argus.

O repositório inclui o aplicativo desktop, ferramentas locais opcionais e um serviço web com cliente Next.js. Integrações dependem de credenciais, permissões, dependências e aplicativos instalados.

01

Voz e texto com Gemini Live

Converse por voz ou envie instruções por texto no aplicativo desktop.

Gemini Live requer uma chave Google e internet; voz também requer microfone.

02

Busca na web e Deep Research

Faça buscas na web ou investigações que reúnem e comparam evidências de várias fontes.

O relatório cita as fontes e só é gravado quando você pede para salvá-lo.

03

Arquivos e programação

Peça resumos de PDFs, extração de texto de imagens, análise de CSV e ajuda com código.

Esses exemplos constam no guia de uso; outras ações podem exigir dependências opcionais.

04

Tela, câmera e controle do computador

Analise a tela ou a câmera, navegue na web, abra aplicativos e execute ações locais.

A disponibilidade depende do sistema, das permissões, das dependências e dos aplicativos instalados.

05

Apresentações PowerPoint

Crie, edite, redesenhe e amplie apresentações widescreen editáveis em .pptx.

Fontes incluem PDF, Word, PowerPoint, Excel, CSV, JSON, Markdown, texto, imagens, áudio, vídeo e URLs. Exportar PDF requer Microsoft PowerPoint.

06

Lembretes, email e mensagens

Crie lembretes, leia e prepare emails e trabalhe com mensagens em aplicativos suportados.

Gmail usa OAuth; emails preparados só são enviados após aprovação explícita. Mensagens dependem dos aplicativos e permissões disponíveis.

Primeiros passos

Instalação pelo código-fonte.

O aplicativo desktop funciona em Windows, macOS e Linux. Docker Compose inicia localmente a API FastAPI e o cliente Next.js; esse perfil não abre a interface desktop.

Linux

Aplicativo desktop instalado pelo código-fonte; launcher: scripts/start_argus.sh.

Comandos de instalaçãoBash

$ git clone https://github.com/reenji/Argus.git Argus
cd Argus
python scripts/setup_argus.py

RequisitosPython 3.11+, internet e chave Gemini com acesso à Live API; microfone para voz.

Outras opçõesInicie com scripts/start_argus.sh.

macOS

Aplicativo desktop instalado pelo código-fonte; launcher: scripts/start_argus.command.

Comandos de instalaçãoTerminal

$ git clone https://github.com/reenji/Argus.git Argus
cd Argus
python scripts/setup_argus.py

RequisitosPython 3.11+, internet e chave Gemini com acesso à Live API; microfone para voz.

Outras opçõesInicie com scripts/start_argus.command ou pelo Finder.

Windows

Aplicativo desktop instalado pelo código-fonte; launcher: scripts/start_argus.bat.

Comandos de instalaçãoPowerShell

PS> git clone https://github.com/reenji/Argus.git Argus
cd Argus
python scripts/setup_argus.py

RequisitosPython 3.11+, internet e chave Gemini com acesso à Live API; microfone para voz.

Outras opçõesInicie com scripts/start_argus.bat ou pelo Explorador de Arquivos.

Web / Docker

Docker Compose inicia a API FastAPI e o cliente web Next.js com PostgreSQL e Redis; não inicia a interface desktop.

Comandos de instalaçãoDocker Compose

$ git clone https://github.com/reenji/Argus.git Argus
cd Argus
docker compose up --build

RequisitosDocker e Docker Compose; não requer instalar Python no host.

Outras opçõesO cliente Next.js fica em http://localhost:3000. Configure segredos próprios antes de publicar o serviço.

01

Clone e configure o ambiente

Execute python scripts/setup_argus.py. O script cria .venv, instala as dependências e copia .env.example para .env se necessário. Requer Git e Python 3.11+.

02

Configure a chave GeminiDefina GEMINI_API_KEY no arquivo .env. Gemini Live requer uma chave Google com acesso à Live API.

03

Inicie o Argus

Use o launcher do seu sistema em scripts/ ou ative .venv e execute argus. O microfone é necessário para conversar por voz.

Dimensionamento

Resultados dos benchmarks executados.

Rodada automatizada de 20/10/2026 no GitHub Actions: API com SQLite, web via Docker Compose com PostgreSQL/Redis e desktop ocioso. Métricas dependem do runner e não representam garantia de produção.

DESKTOP / MEDIÇÃO

Aplicativo desktop — ocioso

Runner Linux x86_64 do GitHub Actions, 60 s, 60 amostras: CPU média 15,851% de um núcleo lógico.

RSS do processo: média de 136,73 MiB e máximo de 136,914 MiB. Cenários típico e intenso não foram executados porque exigem interação real.

GPU dedicada: não indicada como requisito. O modelo generativo é chamado pela API do Gemini.

O repositório não publica um mínimo de armazenamento; o relatório desktop não mediu uso de disco.

API LOCAL / SQLITE TEMPORÁRIO

API HTTP local — SQLite

1, 5, 10, 20 e 40 sessões virtuais; todos os níveis concluíram com 0% de erros. p95: 2,437 ms, 5,656 ms, 6,951 ms, 24,361 ms e 45,545 ms, respectivamente.

TEMPLATES / FLY.IO + RENDER

Docker Compose — PostgreSQL + Redis

1, 5, 10, 20 e 40 sessões virtuais; todos os níveis concluíram com 0% de erros. p95: 4,873 ms, 9,513 ms, 21,320 ms, 76,874 ms e 146,740 ms, respectivamente.

Executado em runner GitHub Actions x86_64 com 4 CPUs lógicas e 15,61 GiB de RAM. Resultados variam com hardware, ambiente e carga.

Relatórios técnicos e artefatos da execução de 20/10/2026:

Execução no GitHub Actions Relatório API / SQLite Relatório Docker Compose Relatório desktop

Releases

Executável portátil ou código-fonte.

A versão 0.1.0 está publicada no GitHub. A release oferece instaladores para Windows x64, macOS arm64 e Linux x86_64, além do arquivo SHA256SUMS.txt.

GITHUB / RELEASESMIT

Baixe o Argus para seu sistema.

A release v0.1.0 já disponibiliza instaladores para Windows x64, macOS arm64 e Linux x86_64. Confira SHA256SUMS.txt antes de instalar.

Linux x86_64ARGUS-v0.1.0-linux-x86_64.deb
Arquivo da release
macOS arm64ARGUS-v0.1.0-macos-arm64.dmg
Arquivo da release
Windows x64ARGUS-0.1.0-windows-x64-setup.exe
Arquivo da release

Como iniciar depois do download

Windows x64: abra o arquivo .exe baixado.

macOS arm64: abra o arquivo .dmg e arraste o Argus para Aplicativos. A primeira execução pode exigir autorização nas configurações de segurança.

Linux x86_64: instale o pacote .deb com o gerenciador de pacotes da sua distribuição. Dependências do sistema podem ser necessárias.

Acompanhar a publicação no GitHub

Publicação da versãoA versão v0.1.0 foi publicada em 07/10/2026 com instaladores e checksums para os três sistemas suportados.A release publica SHA256SUMS.txt com os hashes dos arquivos distribuídos.

Arquitetura

Aplicativo desktop, cliente web e Gemini Live.

01EntradaVoz, texto, arquivos, tela e câmera

02Desktop PyQt6 ou cliente web Next.jsAplicativo desktop e cliente web

03ArgusAssistente pessoal de IA

04FerramentasFerramentas locais e integrações opcionais

05ModeloGemini Live pela API Google

ENTRADAFERRAMENTASRESPOSTA

Exemplo de uso

Um dia de tarefas, do primeiro pedido à revisão.

Demonstração ilustrativa de fluxos com arquivos, pesquisa, apresentações e email. Mensagens e horários são exemplos; emails só são enviados após aprovação.

07:42
VOCÊResuma estes documentos e destaque o que mudou.
07:43
ARGUSResumo pronto, com referências aos arquivos consultados.
09:15
VOCÊCompare estas opções e pesquise o que ainda falta.
09:18
ARGUSComparei as fontes; as citações estão prontas para revisão.
13:30
VOCÊTransforme o relatório em uma apresentação editável.
13:34
ARGUSRascunho da apresentação pronto para revisão.
16:10
VOCÊPrepare um email com o resumo.
16:11
ARGUSRascunho pronto. Só envio depois da sua aprovação.

Segurança

Onde o app executa muda onde os dados ficam.

◌

Dados e credenciais

No desktop, memória e configurações ficam no diretório local do Argus. A chave Gemini só é lembrada se essa opção for escolhida; usa o chaveiro do sistema quando disponível. No serviço web, os dados ficam no PostgreSQL e as chaves Gemini são criptografadas.

◎

Serviços externos e telemetria

O código auditado não inclui analytics, telemetria de produto nem envio de relatórios de falha. Voz, texto, arquivos e outras informações podem ser enviados ao Gemini ou a integrações externas quando você usa esses recursos; consulte a política de privacidade.

!

Permissões e aprovações

Ferramentas de tela, arquivos, navegador e controle do computador dependem das permissões, dependências e aplicativos disponíveis. Emails preparados no Gmail ficam visíveis para revisão e só são enviados após aprovação explícita.

Perguntas

Antes de colocar um agente para trabalhar.

Quais são os requisitos para rodar o Argus?

Quanto de CPU e memória o Argus usa?

O que mostram os benchmarks da API e do serviço web?

O software é gratuito?

Onde ficam meus dados?

Quais modelos e integrações o Argus usa?

Há instaladores para Windows, macOS ou Linux?

Onde encontro documentação e mudanças?

IA que entende.E entra em ação.

Recursos documentados no Argus.

Voz e texto com Gemini Live

Busca na web e Deep Research

Arquivos e programação

Tela, câmera e controle do computador

Apresentações PowerPoint

Lembretes, email e mensagens

Instalação pelo código-fonte.

Aplicativo desktop instalado pelo código-fonte; launcher: scripts/start_argus.sh.

Aplicativo desktop instalado pelo código-fonte; launcher: scripts/start_argus.command.

Aplicativo desktop instalado pelo código-fonte; launcher: scripts/start_argus.bat.

Docker Compose inicia a API FastAPI e o cliente web Next.js com PostgreSQL e Redis; não inicia a interface desktop.

Resultados dos benchmarks executados.

Aplicativo desktop — ocioso

API HTTP local — SQLite

Docker Compose — PostgreSQL + Redis

Executável portátil ou código-fonte.

Baixe o Argus para seu sistema.

Como iniciar depois do download

Aplicativo desktop, cliente web e Gemini Live.

Um dia de tarefas, do primeiro pedido à revisão.

Onde o app executa muda onde os dados ficam.

Dados e credenciais

Serviços externos e telemetria

Permissões e aprovações

Antes de colocar um agente para trabalhar.

IA que entende.
E entra em ação.