🤖 MIA AI Personal Local

Un asistente de IA local con chat moderno para generación de código - 100% offline con Ollama.

✨ Características

• 🤖 Chat Moderno: Interfaz de chat similar a Cursor AI
• 💬 Historial de Conversaciones: Mantiene el historial de tus chats
• 📝 Generación de Código: Genera código desde prompts en lenguaje natural
• 🔧 100% Offline: Funciona completamente local con Ollama
• ⚡ Acciones Automáticas: Copiar e insertar código con un clic
• 🎨 Tema Adaptativo: Se adapta al tema de VSCode

🚀 Instalación

Opción 1: Marketplace (Recomendado)

1. Abre VSCode
2. Ve a Extensiones (Ctrl+Shift+X)
3. Busca "MIA AI Personal Local"
4. Haz clic en "Instalar"

Opción 2: Archivo VSIX

1. Descarga el archivo .vsix
2. En VSCode: Ctrl+Shift+P → "Extensions: Install from VSIX..."
3. Selecciona el archivo descargado

⚙️ Configuración

Backend Local

1. Instala Ollama: https://ollama.ai
2. Descarga el modelo: ollama pull codellama:7b-instruct
3. Ejecuta el backend:

   git clone https://github.com/tu-usuario/mia-ai-local.git
   cd mia-ai-local
   python -m venv venv
   venv\Scripts\activate  # Windows
   pip install -r backend/requirements.txt
   python backend/main.py
   

Configuración de VSCode

• URL del API: http://localhost:8001 (por defecto)
• Modelo: codellama:7b-instruct
• Puerto: 8001

⌨️ Uso

Chat Moderno (Recomendado)

• Ctrl+Shift+M: Abrir chat
• Escribe prompts en lenguaje natural
• Usa Ctrl+Enter para enviar mensajes
• Haz clic en "📝 Insertar" para agregar código al editor

Comandos Clásicos

• Ctrl+Shift+G: Generar código
• Ctrl+Shift+E: Generar y ejecutar
• Ctrl+Shift+P → "MIA AI: Obtener Contexto"

Ejemplos de Prompts

"Crear una función que calcule el factorial"
"Generar una clase para manejar fechas"
"Crear un script que lea un archivo CSV"
"Optimizar este código para mejor rendimiento"
"Agregar manejo de errores a esta función"

🔧 Características Técnicas

• Backend: FastAPI + Python
• Modelo: Ollama (codellama:7b-instruct)
• Frontend: TypeScript + VSCode Extension API
• Chat: Webview con HTML/CSS/JavaScript
• Comunicación: HTTP REST API

🛠️ Desarrollo

Estructura del Proyecto

mia-ai-local/
├── backend/           # Servidor FastAPI
├── vscode-extension/  # Extensión de VSCode
├── demo.py           # Archivo de demostración
└── README.md         # Documentación

Compilar Extensión

cd vscode-extension
npm install
npm run compile
npm run package

Publicar en Marketplace

npm run publish

🆘 Solución de Problemas

El chat no responde

1. Verifica que el backend esté ejecutándose
2. Comprueba la URL en la configuración
3. Ejecuta: python test_api.py

Error de conexión

1. Asegúrate de que Ollama esté instalado
2. Verifica que el modelo esté descargado
3. Comprueba el puerto 8001

La extensión no aparece

1. Reinicia VSCode
2. Verifica la instalación en Extensiones
3. Desinstala y vuelve a instalar

📝 Licencia

MIT License - Ver LICENSE para más detalles.

🤝 Contribuir

1. Fork el proyecto
2. Crea una rama para tu feature
3. Commit tus cambios
4. Push a la rama
5. Abre un Pull Request

📞 Soporte

• Issues: GitHub Issues
• Discussions: GitHub Discussions

¡Disfruta usando MIA AI Personal Local! 🎉