a-funk/image2obsidian

O que image2obsidian faz?

Transfira fotos do iPhone via AirDrop para seu cofre Obsidian — OCR, classificação e roteamento com visão Claude. Habilidade CLI + Claude Code.

Visão Geral

Esta habilidade automatiza o fluxo de trabalho de capturar fotos com seu iPhone e integrá-las diretamente ao seu cofre Obsidian. Ao usar o AirDrop para enviar a foto para o seu computador, o sistema:

1. Recebe a imagem via AirDrop
2. Processa com Claude Vision para extrair texto (OCR) e classificar o conteúdo
3. Roteia a foto para a pasta correta no Obsidian com base na classificação
4. Gera um arquivo Markdown com o texto extraído, tags e link para a imagem

Pré-requisitos

• macOS (para AirDrop)
• Obsidian instalado
• Chave de API do Anthropic Claude
• Python 3.8+ instalado

Instalação

1. Clone o repositório:

   git clone https://github.com/a-funk/image2obsidian.git
   cd image2obsidian
   

2. Instale as dependências:

   pip install -r requirements.txt
   

3. Configure a chave da API do Claude como variável de ambiente:

   export ANTHROPIC_API_KEY=sua-chave-aqui
   

4. (Opcional) Configure o caminho do cofre Obsidian:

   export OBSIDIAN_VAULT_PATH=/caminho/para/seu/cofre
   

Uso

Modo CLI

Monitore uma pasta para novas imagens recebidas via AirDrop:

python image2obsidian.py --watch ~/Downloads/AirDrop

Como habilidade do Claude Code

Adicione ao seu arquivo de configuração do Claude Code (claude_code.json ou similar):

{
  "skills": [
    {
      "name": "image2obsidian",
      "path": "/caminho/para/image2obsidian"
    }
  ]
}

Funcionalidades

• OCR com Claude Vision: Extrai texto de imagens com alta precisão
• Classificação inteligente: Identifica automaticamente se a imagem é uma nota manuscrita, recibo, foto de quadro branco, screenshot, etc.
• Roteamento automático: Cada tipo de imagem é enviado para a pasta apropriada no Obsidian
• Geração de metadados: Inclui tags, data de captura e link para a imagem original
• Suporte a múltiplos formatos: JPEG, PNG, HEIC (via conversão automática)

Estrutura de Pastas no Obsidian

📁 Vault/
├── 📁 Notas/
│   ├── 📁 Manuscritas/
│   ├── 📁 Recibos/
│   └── 📁 Quadro Branco/
├── 📁 Screenshots/
├── 📁 Imagens/
└── 📁 Outros/

Exemplo de Arquivo Gerado

---
title: Recibo - 2024-01-15
date: 2024-01-15T14:30:00
tags: [recibo, comprovante]
type: recibo
source: AirDrop
image: attachments/recibo_20240115_143000.jpg
---

# Recibo

**Texto extraído:**

> Supermercado Exemplo
> R$ 123,45
> Obrigado pela preferência!

**Classificação:** Recibo
**Data de captura:** 2024-01-15

Contribuição

Contribuições são bem-vindas! Abra uma issue ou envie um pull request.

Licença

MIT