Iniciar Jarvis

Detecta duas palmas pelo microfone e abre o Claude Code com uma música de abertura.

Como funciona

O script escuta o microfone em tempo real. Ao detectar dois picos de amplitude (palmas) dentro de uma janela de tempo, ele toca um áudio e abre o Claude Code em um novo terminal. Após 30 segundos, o script encerra automaticamente.

Requisitos

• Python 3.11+
• Windows 10/11
• Claude Code instalado
• ffmpeg instalado (winget install ffmpeg)

Instalação

1. Clone o repositório

git clone https://github.com/seu-usuario/iniciar-jarvis.git
cd iniciar-jarvis

2. Crie e ative o ambiente virtual

python -m venv .venv
.venv\Scripts\activate

3. Instale as dependências

.venv\Scripts\python.exe -m pip install -r requirements.txt

4. Configure o .env

Copie o arquivo de exemplo e edite com seus caminhos:

copy .env.example .env

Edite o .env:

MP3_PATH=C:\caminho\para\seu\audio.wav
CLAUDE_EXE=C:\Users\seu-usuario\.local\bin\claude.exe

Nota: o áudio precisa estar no formato .wav. Para converter um MP3:

ffmpeg -i "seu_audio.mp3" "seu_audio.wav"

5. Execute

Clique duas vezes em iniciar.bat ou rode no terminal:

.venv\Scripts\python.exe detector-palma.py

Calibração

Se o script estiver disparando com ruído ambiente, edite o detector-palma.py:

Parâmetro	Padrão	Descrição
AMPLITUDE_THRESHOLD	0.6	Sensibilidade — suba para reduzir falsos positivos
MAX_GAP_MS	1500	Tempo máximo entre as duas palmas (ms)
MIN_GAP_MS	150	Tempo mínimo entre as duas palmas (ms)

Estrutura

iniciar-jarvis/
├── detector-palma.py   # script principal
├── abrir_claude.vbs    # abre o Claude Code desvinculado do processo Python
├── iniciar.bat         # atalho para executar
├── .env                # seus caminhos (não sobe pro GitHub)
├── .env.example        # modelo do .env
├── requirements.txt    # dependências
└── README.md

Dependências

sounddevice
numpy
python-dotenv