geoffrey-svg/trial-reels-starter

Configuración del Trial Reels Starter

Configuración única. Sigue los pasos en orden, omitiendo lo que ya esté listo. Por paso: una explicación breve en lenguaje sencillo, luego la acción o la pregunta. Guarda los detalles técnicos para ti.

Paso 1: herramientas

1. Ejecuta ./install.sh en esta carpeta. Instala ffmpeg (para crear vídeos) y dos componentes de Python (Pillow y fontTools), omitiendo lo que ya esté presente.
2. Si falta Homebrew, ayuda al usuario a instalarlo desde brew.sh: debe escribir su contraseña de Mac en la Terminal. Explica lo que ve (la contraseña no se muestra al escribir) y vuelve a ejecutar ./install.sh después.
3. Di solo: "Las herramientas están listas."

Paso 2: tu estilo

1. Si el usuario ha pegado un prompt de la AI Suite con un bloque de configuración (JSON con tekst): escribe ese bloque con python3 engine/scripts/instellingen.py --schrijf - y no hagas preguntas.
2. Si no: dile que la forma más fácil de elegir su estilo es en la AI Suite (azulejo Trial Reels, con un ejemplo) y que pegue el prompt. Si no quiere, pregúntale en un solo mensaje: qué tipografía (la lista con nombres comunes y nombres de archivo se obtiene con python3 engine/scripts/instellingen.py --lettertypes), texto en un bloque o letras separadas con borde, qué colores, y si quiere arriba, en medio o abajo en la imagen.
3. Muestra el resultado: python3 engine/scripts/voorbeeld.py (o con --video <ruta> en un vídeo propio). Mira la imagen tú mismo y muéstrasela al usuario. Pregunta si está bien.

Paso 3: ¿cómo quieres publicar?

Si mijn-trial-reels/accounts.json ya existe pero koppeling.json no, es una instalación anterior a esta elección (versión 1.0, mediante Zernio). Entonces no preguntes nada ni crees una nueva clave: python3 engine/scripts/sleutel.py --bewaard zernio, y continúa al paso 5.

Explica en unas pocas frases que los reels llegan a Instagram mediante una conexión en el momento acordado, y que él elige cuál. Da las tres opciones y pregúntale cuál quiere:

1. Metricool, si ya lo usa. Entonces los reels van a su planificador de Metricool, igual que sus otras publicaciones, y las métricas también vienen de Metricool. Necesita: el plan Advanced o superior (incluye la API; desde €43 al mes si paga un año, según metricool.com/pricing el 19 de octubre de 2026) y su cuenta de Instagram como marca en Metricool.
2. Zernio, si no tiene Metricool o quiere mantenerlo separado. Gratis hasta 2 cuentas de Instagram, sin tarjeta de crédito. La programación y las métricas van a través de Zernio.
3. Publicar tú mismo con otro programa (por ejemplo, Later, Buffer o la app de Instagram). Entonces el sistema solo crea los reels; él los publica como trial reel, y las métricas las revisa allí. No se necesita conexión: python3 engine/scripts/sleutel.py --zelf, y continúa al paso 5.

Paso 4: configurar la conexión

Metricool

1. ./install.sh --metricool: prepara cloudflared. Metricool solo acepta un vídeo a través de una dirección pública; para eso el sistema hace pública la carpeta de reels brevemente, solo durante la programación.
2. Pide al usuario que busque sus datos de API en Metricool (según lo descrito en el centro de ayuda de Metricool, help.metricool.com, "Cómo encontrar tu ID de usuario de Metricool", consultado el 19 de octubre de 2026):
   1. El token: en Metricool, en Configuración de cuenta, sección API. Solo está disponible en los planes Advanced y Custom.
   2. El número de usuario (userId): abre Metricool en el navegador y abre una marca. En la barra de direcciones verás algo como ...?blogId=12345&userId=1234567; el número después de userId= es el número de usuario (el número después de blogId= es la marca, no es necesario).
3. Él pega el token y el número de usuario en el chat. Guárdalos con printf '%s' '<token>' | python3 engine/scripts/sleutel.py --metricool --user <número_de_usuario>. No repitas el token en tu respuesta. El script primero los prueba con Metricool; si no funcionan, pídele que los revise (y que verifique si su plan incluye la API).
4. python3 engine/scripts/koppel.py muestra las marcas que tienen una cuenta de Instagram. Activa la correcta con python3 engine/scripts/koppel.py --gebruik <nombre_de_instagram>. Si esa cuenta de Instagram está vinculada a dos marcas, el script pedirá el número de la marca: pregúntale al usuario cuál es la marca y usa --gebruik <número>.

Zernio

1. Pide al usuario que inicie sesión o cree una cuenta en zernio.com. Allí abre API keys y hace clic en Create API key. Copia la clave inmediatamente: Zernio solo la muestra una vez. Una clave comienza con sk_.
2. Él pega la clave en el chat. Guárdala con printf '%s' '<clave>' | python3 engine/scripts/sleutel.py. No repitas la clave en tu respuesta. Si no funciona, pídele que cree una nueva.
3. python3 engine/scripts/koppel.py --link da un enlace para conectar Instagram. Antes de que lo abra: en Instagram, primero cambia a la cuenta que quiere conectar, porque Instagram conecta la cuenta con la que ha iniciado sesión.
4. Después, python3 engine/scripts/koppel.py y python3 engine/scripts/koppel.py --gebruik <nombre>.

En ambos casos: Instagram exige una cuenta profesional (creador o empresa) que sea pública, y los trial reels solo se pueden usar a partir de 200 seguidores; por debajo, el sistema publica reels normales, que también ven los seguidores. Dilo. Más cuentas se pueden añadir con koppel.py --erbij <nombre> (no --gebruik, que reemplaza la lista).

Paso 5: tus reglas de publicación y cuándo un reel es ganador

Pregunta esto en un solo mensaje, incluyendo el valor predeterminado para que pueda decir "está bien":

1. ¿Cuántos reels por día por cuenta? Predeterminado: 5. Consejo: en una cuenta nueva, empieza con 2 a 5 por día. Instagram, a través de una conexión, a menudo no permite más de unos 5 trial reels por cuenta al día (medido en una cuenta propia; por encima, Instagram los rechazó), y las cuentas de prueba que recibieron decenas al día dejaron de tener alcance.
2. ¿Cuántos minutos como mínimo entre ellos? Predeterminado: 45 (mínimo 30).
3. ¿Entre qué horas? Predeterminado: entre las 9:00 y las 21:00, en la zona horaria de su computadora (pregúntale si no coincide).
4. ¿Compartir con tus seguidores? ¿Publica él mismo el trial reel que funciona bien en la app de Instagram, o deja que Instagram lo haga automáticamente?
5. ¿Cuándo un reel es ganador? Predeterminado: si alcanza al menos 3 veces las visitas habituales de la cuenta y al menos 500 visitas. Solo necesario con una conexión (Metricool o Zernio).

Guarda la respuesta con python3 engine/scripts/instellingen.py --schrijf -, incluyendo solo los bloques posten y winners (por ejemplo, {"posten": {"per_dag": 3, "minuten_tussen": 45, "van": 9, "tot": 21, "tijdzone": "Europe/Amsterdam", "doorzetten": "zelf"}, "winners": {"factor": 3, "min_views": 500}}). Si el script rechaza algo, explica por qué y vuelve a preguntar. Luego di en una frase lo que está configurado ahora (python3 engine/scripts/instellingen.py); si en la ventana caben menos por día de lo elegido, eso aparecerá.

Listo

Di en dos o tres frases lo que ahora se puede hacer: proporcionar vídeos más textos, ver los reels, aprobar la propuesta (o, si publica él mismo, descargar los reels), y después de unos días pedir las métricas. Ofrécete a hacer una primera ronda pequeña de inmediato (por ejemplo, 5 reels).