jgm-source / jarvis-opensource

# JARVIS — fork em português do MARK LV
**Por João Gabriel.** Este projeto é um fork do
MARK LV, de FatihMakes, um assistente
de voz estilo JARVIS que ouve, vê, fala e controla o computador usando a
Gemini Live API. O código original continua com crédito e licença do autor
(CC BY-NC 4.0, uso pessoal e não comercial). O README original está logo abaixo.
## O que foi adicionado neste fork
Plugins novos (pasta `plugins/`):
| Plugin | O que faz |
|---|---|
| `bom_dia.py` | Briefing matinal por voz |
| `brain_economy.py` | Cérebro alternativo e barato (outro provedor de LLM + voz Edge TTS / Fish Audio) |
| `cakto_sales.py` | Vendas e pedidos da Cakto por voz |
| `focus_mode.py` | Modo foco |
| `gemini_accounts.py` | Rodízio de chaves Gemini (secundária e terciária) |
| `groq_listen.py` | Transcrição de voz pela Groq (Whisper) |
| `humor_mode.py` | Modo humor ácido |
| `music_control.py` | Controle de música de fundo |
| `organizer.py` | Tarefas e agenda em JSON local |
| `phrase_blocklist.py` | Bloqueio de frases |
| `rastracking.py` | Consulta de rastreio Rastracking |
| `trello_control.py` | Quadros, listas e cartões do Trello por voz |
Núcleo novo (pasta `core/`): `brain.py`, `briefing_sources.py`, `groq_stt.py`,
`holo.py`, `music.py`, `numwords.py`, `usage.py`, `agenda_sync.py` (espelho
de duas vias entre a agenda local e uma lista do Trello, com tela
📅 AGENDAMENTOS no painel ⚙ e comando por voz "muda a call para 17h").
O cérebro econômico tem limite de contexto e recuperação automática, com
diagnóstico em `memory/brain_debug.txt`. Além disso: personalidade de
mordomo em `core/prompt.txt`, mais vozes Gemini, filtro por nome e ajustes em
avatar, TTS, STT, hotkey e dashboard. O script `criar-atalho-jarvis.bat` cria
um ícone na área de trabalho que abre o JARVIS sem janela de terminal.
## Instalação rápida (Windows)
 [code] 
Na primeira execução a tela de setup pede a chave Gemini. As chaves dos
plugins ficam em ⚙ → PLUGIN SETTINGS. Um modelo do arquivo de configuração
está em `config/api_keys.example.json`.
Guia ilustrado passo a passo: docs/instalacao.html
(abra o arquivo no navegador). Para atualizar quando sair versão nova, sem
perder chaves nem memória: docs/atualizar.html.
## Intro de abertura
Na primeira abertura em cada PC, antes da saudação, as linhas da malha do
JARVIS constroem um cartão, um checkout, a palavra RASTRACKING e o Pixel da
Meta, que absorve os dados e solta dinheiro; no fim as linhas giram e se
encaixam no rosto do JARVIS, que então faz a saudação (`core/intro.py`).
Dura cerca de 18 segundos e toca **uma única vez** (marca `intro_shown` em
`config/api_keys.json`). Para tocar em toda abertura, use
`"intro_always": true`; para nunca tocar, `"intro_shown": true`. Um
protótipo em HTML da mesma animação está em `docs/intro-preview.html`.
## Recado na primeira abertura
Na primeira vez que o JARVIS abre em um PC, logo depois da saudação, ele dá um
recado do criador deste fork e abre o Instagram
@joao.tracker no navegador. Isso
aconte