<<<<<<< HEAD

⛏️ Knowledge Miner

Herramienta de gestión inteligente del conocimiento con IA

By Darío Cardona Sosa

🚀 Demo • 📦 Instalación • 🎯 Características • 📚 Documentación

---

🎯 ¿Qué hace Knowledge Miner?

Convierte cualquier archivo en conocimiento estructurado usando IA.

⚡ En 3 pasos simples:

1. 📤 Sube archivos (audio, PDF, Word, PowerPoint, texto)
2. 🤖 IA los analiza (Whisper transcribe + OpenAI extrae conocimiento)
3. 📚 Obtienes Q&A (preguntas/respuestas + conceptos clave organizados)

🚀 El poder:

• 🎵 Grabación de reunión → Base de conocimiento con 25+ preguntas clave
• 📄 Manual técnico → Q&A searchable con conceptos importantes
• 🎓 Contenido educativo → Conocimiento estructurado para consulta rápida

---

✨ Características Principales

🎵 Audio	📄 Documentos	🤖 IA	📊 Gestión
Transcripción con Whisper AI	PDF, DOCX, PPTX, TXT	OpenAI + Claude	Múltiples bases
50+ idiomas	Extracción real de texto	Q&A automático	Dashboard dinámico
Hasta 25MB	Hasta 50MB	Conceptos clave	Exportación JSON

🔥 Tecnologías:

• Frontend: React 18 + TypeScript + Tailwind CSS
• IA: OpenAI Whisper + GPT + Claude (Anthropic)
• Procesamiento: PDF.js + mammoth + Whisper API
• Estado: Context API + localStorage

---

🚀 Demo

📱 Screenshots

🏠 Dashboard          📤 Captura           🔄 Transformación
┌─────────────────┐   ┌─────────────────┐   ┌─────────────────┐
│ ⛏️ Knowledge    │   │ Arrastra archivos│   │ 🤖 Analizando...│
│    Miner        │   │ 📄 PDF  🎵 MP3  │   │                │
│                 │   │ 📝 DOCX 🎤 WAV  │   │ ✅ 25 Q&A      │
│ 📊 25 Q&A       │   │ 📊 PPTX 📄 TXT  │   │ 💡 15 Conceptos │
│ 💡 15 Conceptos │   │                 │   │ 📊 Resumen     │
│ 🎯 3 Bases KB   │   │ ⚡ Procesando... │   │ 💾 Guardar     │
└─────────────────┘   └─────────────────┘   └─────────────────┘

🎬 Flujo de Trabajo

graph LR
    A[📤 Subir Archivo] --> B[🤖 Procesar IA]
    B --> C[📝 Generar Q&A]
    C --> D[💡 Extraer Conceptos]
    D --> E[📚 Guardar Base KB]
    E --> F[🔍 Explorar/Buscar]

Loading

---

📦 Instalación

Prerrequisitos

• Node.js 18+
• npm o yarn
• OpenAI API Key (obtener aquí)

Instalación Rápida

# 1. Clonar repositorio
git clone https://github.com/tu-usuario/knowledge-miner.git
cd knowledge-miner

# 2. Instalar dependencias
npm install

# 3. Configurar environment
cp .env.example .env
# Editar .env con tu OpenAI API key

# 4. Ejecutar aplicación
npm run dev

# 5. Abrir en navegador
# http://localhost:3000

Configuración de APIs

# .env
VITE_OPENAI_API_KEY=sk-tu-openai-key-aqui
VITE_ANTHROPIC_API_KEY=sk-ant-tu-claude-key-aqui # Opcional

---

🎮 Uso

1. Crear Base de Conocimiento

🏠 Dashboard → ➕ Nueva Base → Ingresar nombre → ✅ Crear

2. Capturar Conocimiento

📤 Capturar → Arrastra archivos → ⏳ Esperar procesamiento → ✅ Listo

3. Transformar con IA

🔄 Transformar → Seleccionar archivo → 🤖 Analizar → 💾 Guardar

4. Explorar Resultados

📚 Explorar → 🔍 Buscar Q&A → 💡 Ver conceptos → 📊 Estadísticas

---

🛠️ Desarrollo

Estructura del Proyecto

knowledge-miner/
├── 📁 src/
│   ├── 🎨 components/           # Componentes React
│   │   ├── capture/            # Módulo de captura
│   │   ├── transform/          # Módulo de transformación
│   │   ├── browse/             # Explorador de conocimiento
│   │   └── common/             # Componentes compartidos
│   ├── 🧠 context/             # Estado global (Context API)
│   ├── ⚙️ services/            # Servicios de IA y procesamiento
│   └── 🔧 utils/               # Utilidades y helpers
├── 📦 package.json
├── ⚛️ vite.config.ts
└── 📖 README.md

Scripts Disponibles

npm run dev          # Desarrollo (localhost:3000)
npm run build        # Build para producción
npm run preview      # Preview del build
npm run lint         # Linting con ESLint

Arquitectura

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   📱 Frontend   │    │   🤖 IA APIs    │    │  💾 Storage     │
│                 │    │                 │    │                 │
│ React + TS      │ ←→ │ OpenAI Whisper  │    │ localStorage    │
│ Tailwind CSS    │    │ OpenAI GPT      │    │ Context API     │
│ Context API     │    │ Claude (opt)    │    │ JSON export     │
└─────────────────┘    └─────────────────┘    └─────────────────┘

---

🧪 Testing

Archivos de Prueba Recomendados

Tipo	Formato	Tamaño	Descripción
🎵 Audio	MP3, WAV	< 25MB	Grabación de reunión
📄 Documento	PDF	< 50MB	Manual o artículo
📝 Texto	DOCX	< 50MB	Documento estructurado
📊 Presentación	PPTX	< 50MB	Slides con contenido
📄 Texto plano	TXT	< 10MB	Contenido simple

Casos de Prueba

# Transcripción
✅ Audio MP3 → Texto preciso
✅ Múltiples idiomas
✅ Calidad variable de audio

# Procesamiento
✅ PDF multipágina → Texto extraído
✅ DOCX con formato → Contenido limpio
✅ Archivos grandes → Manejo correcto

# IA Analysis
✅ Contenido técnico → Q&A relevantes
✅ Reuniones → Conceptos clave
✅ Educativo → Estructura clara

---

📈 Roadmap

v0.9.0 ✅ Actual

• ✅ Core funcionalidad completa
• ✅ IA integrada (Whisper + OpenAI)
• ✅ UI moderna con glassmorphism
• ✅ Manejo robusto de errores

v1.0.0 🎯 Próximo (Enero 2025)

• 🔄 Testing completo
• 📖 Documentación final
• 🐛 Bug fixes menores
• 🚀 Release estable

v1.1.0 ⏳ Futuro

• 🗄️ Base de datos SQLite
• 🔍 Búsqueda semántica
• 📊 Analytics avanzados
• 🌐 Modo multiusuario

---

🤝 Contribuir

¡Las contribuciones son bienvenidas!

Cómo contribuir:

1. Fork el proyecto
2. Crea una rama (git checkout -b feature/increible-feature)
3. Commit tus cambios (git commit -m 'Add: increíble feature')
4. Push a la rama (git push origin feature/increible-feature)
5. Abre un Pull Request

Tipos de contribuciones:

• 🐛 Bug fixes
• ✨ Nuevas características
• 📖 Documentación
• 🎨 Mejoras de UI/UX
• ⚡ Optimizaciones de performance

---

📝 Licencia

Este proyecto está bajo la Licencia MIT. Ver LICENSE para más detalles.

---

👨‍💻 Autor

Darío Cardona Sosa

• 🌐 Website: tu-website.com
• 📧 Email: [email protected]
• 💼 LinkedIn: tu-linkedin
• 🐦 Twitter: @tu-twitter

---

🙏 Agradecimientos

• OpenAI por Whisper y GPT APIs
• Anthropic por Claude API
• React Team por el increíble framework
• Tailwind CSS por el sistema de diseño
• Vite por la herramienta de build ultrarrápida

---

📊 Estadísticas del Proyecto

---

¿Te gusta Knowledge Miner? ¡Dale una ⭐ en GitHub!

⭐ Star en GitHub • 🐛 Reportar Bug • 💡 Solicitar Feature

---

Hecho con ❤️ por Darío Cardona Sosa en Colombia 🇨🇴

======= # Knowledge-Miner Convierte cualquier archivo en conocimiento estructurado usando IA. >>>>>>> 849c782f319682e03c520c571eb59f5722ddce0c