Jarvis • Assistente Self-Hosted Seguro e Visual

Projeto completo para automação local com FastAPI, Socket.IO, autenticação JWT, políticas de execução e feedback visual em tempo real na web e no desktop.

FastAPI + Socket.IO JWT obrigatório em /api/execute Conscience + Allowlist Desktop FX Systemd Ready Pytest inicial

Abrir README Instalação Completa Checklist Técnico

Guia Rápido

Setup

python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt PYTHONPATH=. python3 scripts/bootstrap_db.py --create-admin admin admin

Execução

./cli.sh start ./cli.sh status ./cli.sh fx-on ./cli.sh logs

Funcionalidades

Backend Seguro

Endpoints REST e Socket.IO com autenticação JWT e validação de conexão por token.

Execução Controlada

/api/execute protegido por JWT, policy de segurança e allowlist de comandos.

Visual em Ação

Efeito visual no dashboard web e orb desktop com fx-on/fx-off.

Documentação e Diagramas

README

Visão geral e comandos principais.

Abrir

INSTALL

Instalação completa, systemd e ambiente.

Abrir

Checklist

Status real do projeto e próximos passos.

Abrir

Versionamento e Changelog

Versão	Data	Status	Resumo
v0.4.0	2026-05-03	Atual	Hardening em `/api/execute`, testes iniciais, systemd, desktop FX e docs visuais completas.
v0.3.0	2026-05-03	Estável	Autenticação JWT em login e Socket.IO, scaffolds backend/frontend e CLI funcional.
v0.2.0	2026-05-03	Histórico	Estrutura inicial, scripts e documentação base.
v0.5.0 (planejada)	TBD	Planejada	CI, Docker, melhorias de segurança (rate limiting/refresh tokens), expansão de testes.

Downloads e Releases

Código-fonte

Clone direto do repositório:

git clone hhttps://github.com/ksevendeveloper/Jarvis.git jarvis cd jarvis

Pacote local (manual)

Gerar tarball para distribuição interna:

git archive --format=tar.gz --output jarvis-v0.4.0.tar.gz main

Autores e Contribuição

Equipe Projeto Jarvis

Mantenedores: equipe local de desenvolvimento e automação.

Contato: atualize este bloco com e-mails/links do time.

Como contribuir

1. Crie branch feature.

2. Rode testes pytest -q.

3. Abra PR com descrição técnica e impacto.

Roadmap

Segurança

Rate limiting, refresh tokens, auditoria detalhada por usuário.

IA e Voz

Integração Ollama completa e STT/TTS local funcional.

DevOps

CI/CD, Docker, monitoramento e hardening de produção.