InstagramToMealie
Conversor simple que importa URLs de Instagram directamente como recetas en Mealie, integrando assets multimedia mediante Flask y Python.
Ficha actualizada 18 sept 2026, 20:58 · upstream 17 sept 2026, 9:07 · release v1.4.6
Qué es InstagramToMealie
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
InstagramToMealie es una herramienta de automatización escrita en Python que actúa como puente entre la API pública de Instagram (vía Instaloader) y la plataforma Mealie. Su función principal es extraer metadatos de publicaciones de Instagram, incluyendo imágenes, videos y descripciones, para crear automáticamente entradas de recetas en un servidor Mealie autoalojado.
El proyecto requiere una configuración previa en la instancia de Mealie, específicamente la integración con modelos de lenguaje locales como Ollama (ej. qwen2.5:7b) para procesar el contenido textual y generar descripciones o títulos si es necesario. La autenticación con Instagram se gestiona mediante archivos de sesión generados manualmente o credenciales en variables de entorno, aunque esta última opción requiere desactivar la autenticación de dos factores.
La arquitectura es ligera y está diseñada para ejecutarse como servicio independiente junto a Mealie, exponiendo una interfaz web y un endpoint API RESTful. Soporta despliegue mediante Docker con imágenes precompiladas o construcción desde fuente, facilitando su integración en orquestadores como Docker Compose.
- Importación manual de recetas: El usuario pega la URL de una publicación de Instagram en la interfaz web y se crea automáticamente la entrada en Mealie.
- Automatización con iOS Shortcuts: Se puede invocar vía GET con parámetro ?url=<URL> para importar recetas desde dispositivos móviles sin interfaz gráfica.
- Integración en flujos de trabajo personalizados: Uso del endpoint POST /api para recibir URLs en JSON y obtener respuestas estructuradas con slugs de recetas generados.
- Gestión de assets multimedia: Extracción e importación de imágenes y videos asociados a la publicación original directamente al repositorio de recetas.
- Integración nativa con Instaloader para autenticación robusta mediante archivos de sesión.
- Soporte Docker oficial con imagen precompilada en jotec2002/instagramtomealie.
- Endpoint API RESTful que devuelve JSON estructurado con slug de la receta y estado de la importación.
- Configuración flexible para habilitar o deshabilitar etiquetas de Instagram en las recetas de Mealie.
- Compatibilidad con modelos locales de Ollama para procesamiento de texto sin depender de APIs externas costosas.
- Requiere configuración manual previa en Mealie (OpenAI/Ollama) antes de que la herramienta funcione correctamente.
- La autenticación con credenciales en variables de entorno exige desactivar la autenticación de dos factores en la cuenta de Instagram.
- No incluye soporte para Docker Compose nativo, aunque se proporciona ejemplo de archivo compose.yaml.
- El uso de contraseñas en texto plano en variables de entorno no es seguro y debe evitarse en entornos de producción.
- La detección de bots de Instagram puede bloquear accesos si se realizan múltiples intentos desde IPs diferentes sin sesiones válidas.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar junto a Mealie usando Docker Compose. Montar el archivo de sesión de Instagram en /app/session-file o usar credenciales (desactivando TFA). Asegurar que la versión de Mealie sea compatible con la API v2.1.0. Configurar timeouts para peticiones OpenAI/Ollama si es necesario.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.