Um plugin avançado para Obsidian que transforma documentos PDF em notas estruturadas e interconectadas usando inteligência artificial do Google Gemini.
- Extração de Texto: Processamento robusto de PDFs usando PDF.js
- Análise com IA: Utiliza Google Gemini para análise semântica profunda
- Processamento Assíncrono: Web Workers mantêm a interface responsiva
- Resumos Automáticos: Resumos executivos concisos com pontos-chave
- Extração de Conceitos: Identificação e categorização de conceitos importantes
- Perguntas e Respostas: Geração automática de Q&A educativo
- Metadados Ricos: Preservação de informações do documento original
- Diagramas Mermaid: Mapas mentais, fluxogramas, timelines e gráficos comparativos
- Fórmulas LaTeX: Formatação automática de expressões matemáticas
- Ícones Integrados: Suporte ao plugin Iconize para interface visual rica
- Ribbon Icon: Acesso rápido via barra lateral
- Command Palette: Comandos acessíveis via Ctrl+P
- Drag & Drop: Detecção automática de PDFs adicionados ao vault
- Configurações Avançadas: Controle total sobre o processamento
- Obsidian v0.15.0 ou superior
- Chave da API Google Gemini (gratuita em Google AI Studio)
- Iconize: Para ícones nas notas
- LaTeX Suite: Para edição avançada de equações
- Mermaid: Para renderização de diagramas (geralmente já incluído)
- Clone ou baixe este repositório
- Copie a pasta para
<vault>/.obsidian/plugins/obsidian-codex/ - Execute
npm installna pasta do plugin - Execute
npm run buildpara compilar - Ative o plugin nas configurações do Obsidian
- Instale o plugin BRAT
- Adicione este repositório:
https://github.com/seu-usuario/obsidian-codex-plugin - Ative o plugin nas configurações
- Obtenha uma chave gratuita em Google AI Studio
- Vá para Configurações → Codex
- Cole sua chave da API no campo correspondente
- Escolha o modelo (recomendado: Gemini 2.5 Flash)
- Pasta de Saída: Defina onde as notas serão salvas
- Conteúdo: Escolha quais seções incluir (resumo, conceitos, Q&A)
- Formatação: Ative/desative diagramas, LaTeX e ícones
- OCR: Configure para PDFs escaneados (futuro)
- Clique no ícone do Codex na barra lateral
- Selecione um arquivo PDF
- Aguarde o processamento
- A nota será criada automaticamente
- Pressione
Ctrl+P(ouCmd+Pno Mac) - Digite "Codex" e selecione "Processar PDF"
- Escolha o arquivo e aguarde
- Arraste um PDF para seu vault
- O Codex detectará automaticamente
- Clique no ícone quando solicitado
---
tags: [codex-generated, pdf-processed]
created: 2024-01-15T10:30:00Z
source: documento-exemplo.pdf
author: João Silva
icon: fas-file-pdf
---
# ::fas-file-pdf:: Título do Documento
## ::fas-info-circle:: Informações do Documento
| Campo | Valor |
|-------|-------|
| **Autor** | João Silva |
| **Páginas** | 25 |
| **Data de Criação** | 15/01/2024 |
---
## ::fas-clipboard-list:: Resumo
> [!ABSTRACT] Resumo Executivo
> Este documento apresenta uma análise abrangente sobre...
### Pontos-Chave
- **Conceito principal identificado**
- **Metodologia inovadora apresentada**
- **Resultados significativos obtidos**
---
## ::fas-lightbulb:: Conceitos-Chave
### Teorias
- **Teoria X** ::fas-star::
Descrição detalhada da teoria e sua relevância...
### Termos Técnicos
- **Termo Y** ::fas-star-half-alt::
Definição clara e contexto de uso...
---
## ::fas-question-circle:: Perguntas e Respostas
### Questão 1 ::fas-smile::
**Qual é o conceito principal apresentado?**
> [!SUCCESS] Resposta
> O conceito principal é...
---
## ::fas-project-diagram:: Visualizações
### Mapa Mental
```mermaid
mindmap
root((Título do Documento))
Teorias
Teoria X
Teoria Y
Termos
Termo A
Termo BA famosa equação de Einstein relaciona energia e massa...
## 🔧 Desenvolvimento
### Estrutura do Projeto
src/ ├── main.ts # Classe principal do plugin ├── settings.ts # Interface de configurações ├── web-worker.ts # Processamento assíncrono ├── agents/ # Agentes especializados │ ├── geminiClient.ts # Cliente da API Gemini │ ├── ingestionAgent.ts # Extração de PDF │ └── orchestrator.ts # Coordenação dos agentes └── utils/ # Utilitários ├── markdownFormatter.ts # Formatação de saída ├── diagramGenerator.ts # Geração de diagramas └── latexFormatter.ts # Formatação LaTeX
### Scripts Disponíveis
```bash
npm run dev # Desenvolvimento com hot reload
npm run build # Build de produção
npm run version # Bump de versão
O plugin utiliza uma arquitetura multiagente:
- Agente de Ingestão: Extrai texto e metadados do PDF
- Cliente Gemini: Interage com a API para análise semântica
- Orquestrador: Coordena o fluxo entre agentes
- Formatador: Gera a saída final em Markdown
Contribuições são bem-vindas! Por favor:
- Fork o repositório
- Crie uma branch para sua feature (
git checkout -b feature/AmazingFeature) - Commit suas mudanças (
git commit -m 'Add some AmazingFeature') - Push para a branch (
git push origin feature/AmazingFeature) - Abra um Pull Request
- Suporte a OCR para PDFs escaneados
- Processamento de múltiplos arquivos
- Templates personalizáveis
- Suporte a outros formatos (DOCX, TXT)
- Integração com outros LLMs
- Análise de sentimento
- Interface gráfica avançada
- Colaboração em tempo real
- Integração com bases de conhecimento
- PDFs com proteção por senha não são suportados
- Arquivos muito grandes (>50MB) podem causar lentidão
- OCR ainda não implementado
Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.
- Equipe do Obsidian pelo excelente framework de plugins
- Google pelo acesso à API Gemini
- Comunidade open source pelas bibliotecas utilizadas
- Issues: GitHub Issues
- Discussões: GitHub Discussions
- Discord: Canal #plugin-dev no servidor oficial do Obsidian
Desenvolvido com ❤️ por Manus AI