Codex · Construir apps

Crea una app con Codex, del código al instalador y su landing

Elige una de las siete apps y constrúyela de principio a fin con el mismo método: por etapas, comprobando cada una, hasta un instalador .exe para Windows y su propia landing publicada. Además, cinco prácticas para ir más allá: añadir IA a una app con Codex o con la API gratuita de Gemini, crear vuestra propia app de IA local con Gemma 4, conectar herramientas con MCP y modelar en 3D con Blender usando Computer Use. Dos sesiones de tres horas, presencial en el Cibernàrium de Barcelona y online.

Siete apps, un método

Elige la app que vas a construir

Todas siguen las mismas doce etapas y terminan igual: app de escritorio, instalador de Windows y landing publicada. En clase la demostración se hace con Focus Studio; cada persona puede seguirla o elegir otra.

Cada etapa sigue el mismo ciclo

  1. Pedir el plan
  2. Aprobar o corregir
  3. Construir
  4. Comprobar con la lista
  5. Guardar con un commit
Paso a paso

Doce etapas para cada app

Cada etapa tiene su objetivo, el prompt para copiar, cómo comprobar que ha salido bien y qué hacer si algo falla. No paséis a la siguiente hasta que la comprobación sea correcta.

Focus Studio

App de escritorio de tipo Pomodoro para trabajar por bloques de tiempo, con proyectos, tareas, estadísticas e idiomas.

Descargar materiales

Sesión 1 · De la idea a una app que funciona

00Preparar la carpeta y los materiales

Objetivo tener la carpeta del proyecto abierta en Codex con todos los ficheros de trabajo.

Si todavía no tenéis Codex instalado y configurado, empezad por el bloque 0 · Instalar y configurar Codex. Después:

  1. Descargad los materialesfocus-studio-materials.zip (13 KB, 8 ficheros).
  2. Descomprimid la carpetaDentro de vuestra carpeta de usuario, por ejemplo Documentos\focus-studio-materials. Fuera de OneDrive y de la raíz de C:\.
  3. Abridla en CodexAdd new project (Ctrl+O) y elegid la carpeta. Dejad los permisos en Ask for approval.
  4. Comprobad que Codex la entiendeCon el prompt de abajo.
Prompt
Lista los ficheros de esta carpeta y explícame en [tu idioma], en una línea cada uno, para qué sirve. No cambies nada.

Qué hay en la carpeta (y cómo crear cada fichero si no podéis descargar el zip)

AGENTS.mdInstrucciones que Codex lee siempre en esta carpeta.
Crear este fichero con un prompt
Prompt
Crea en esta carpeta un AGENTS.md para el proyecto Focus Studio: app de escritorio de tipo Pomodoro para trabajar por bloques de tiempo, con proyectos, tareas, estadísticas e idiomas. Se hace con HTML, CSS y JavaScript sin frameworks y se empaqueta para Windows con Electron. Indica: responde siempre en el idioma del usuario; explica el plan antes de cambiar ficheros y espera confirmación; haz una etapa cada vez; trabaja solo dentro de esta carpeta y no borres nada sin preguntar; avisa antes de órdenes que necesiten internet; todos los textos visibles salen de textos.json (ca, es, en); los datos se guardan en el dispositivo; accesible con teclado; al terminar cada etapa, pasa las comprobaciones de proves_focus_studio.md.
brief_focus_studio_es.md / brief_focus_studio_ca.mdEl encargo: qué hace la app y cómo se comprueba.
Crear este fichero con un prompt
Prompt
Crea brief_focus_studio_es.md con el encargo de Focus Studio: App de escritorio de tipo Pomodoro para trabajar por bloques de tiempo, con proyectos, tareas, estadísticas e idiomas. Incluye objetivo, qué tiene que hacer por etapas (el temporizador; proyectos y tareas; estadísticas; idiomas ca/es/en desde textos.json; exportar e importar JSON e importar CSV; ventana Electron con icono e instalador; landing publicada en GitHub Pages), aspecto, fuera de alcance y cómo sabremos que está bien.
textos.jsonTodos los textos de la interfaz en ca, es y en.
Crear este fichero con un prompt
Prompt
Crea textos.json con tres bloques, "ca", "es" y "en", con las mismas claves en los tres para todos los textos que necesitará la interfaz de Focus Studio según el brief: botones, campos, filtros, estadísticas, configuración, mensajes de confirmación y de error. Traduce cada texto con naturalidad.
proves_focus_studio.mdComprobaciones de cada etapa, con casillas.
Crear este fichero con un prompt
Prompt
Crea proves_focus_studio.md con una lista de comprobaciones con casillas para cada etapa de Focus Studio según el brief, más idiomas, datos (exportar, importar JSON y CSV, CSV mal formado), escritorio, instalador de Windows, landing y publicación. Cada comprobación tiene que poder verificarse mirando la app.
icona.pngIcono de 512 × 512 para el instalador.
Crear este fichero con un prompt
Prompt
Crea icona.png de 512 × 512 píxeles para Focus Studio: un cuadrado redondeado de color oscuro con un símbolo sencillo y claro que represente la app. Usa Python con Pillow; si no está instalado, pídeme permiso para instalarlo.
ComprobaciónCodex enumera los 8 ficheros y explica AGENTS.md y el brief sin modificar nada.
Si algo fallaSi Codex no ve los ficheros, la carpeta abierta es la de fuera: el zip crea una subcarpeta. Abrid focus-studio-materials.
01Leer el encargo y planificar

Objetivo que Codex explique qué va a construir y en qué orden antes de escribir código.

Prompt
Lee AGENTS.md y brief_focus_studio_es.md. Explícame en [tu idioma] qué vamos a construir y propón un plan en estas etapas: 2 el temporizador, 3 proyectos y tareas, 4 estadísticas, 5 idiomas, 6 punto de recuperación, 7 datos, 8 app de escritorio, 9 instalador de Windows, 10 landing de la app, 11 publicación. Para cada etapa, dime qué ficheros crearás o cambiarás. Hazme las preguntas que necesites. No cambies nada todavía.

Responded a sus preguntas en el mismo chat. Si el plan no os convence, pedid el cambio antes de aprobarlo.

ComprobaciónHay un plan por etapas, con ficheros concretos, y la carpeta sigue igual.
Si algo fallaSi Codex empieza a crear ficheros, paradlo con el botón de detener y recordadle que AGENTS.md pide plan primero.
02El temporizador

Objetivo una primera versión que ya funciona: el reloj de concentración con sus pausas.

Prompt
Etapa 2. Crea index.html, styles.css y app.js con el temporizador del brief: concentración de 25 minutos, pausa corta de 5 y pausa larga de 15 cada cuatro bloques; botones Empezar, Pausa y Reiniciar; aviso sonoro y visual al terminar; reloj grande; modo claro y oscuro. Carga los textos desde textos.json, de momento en castellano. Para probarlo, sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado en http://localhost:8000 y pasa las comprobaciones de la etapa 2 de proves_focus_studio.md.

Para comprobar el aviso sin esperar 25 minutos, pedid a Codex un modo de prueba temporal:

Prompt
Añade un modo de prueba que se active con ?prueba en la dirección y haga que cada bloque dure 10 segundos. Explícame cómo activarlo.
ComprobaciónEl reloj cuenta hacia atrás, los tres botones funcionan, suena el aviso y después del cuarto bloque llega la pausa larga.
Si algo fallaSi la página sale sin textos, la habéis abierto con doble clic: el navegador no deja leer textos.json desde el disco. Abridla en http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.
03Proyectos y tareas

Objetivo organizar el trabajo y elegir en qué tarea se concentra cada bloque.

Prompt
Etapa 3. Añade proyectos y tareas: crear, editar, marcar como hechas y borrar con confirmación. Cada tarea pertenece a un proyecto y tiene una estimación de bloques. Antes de empezar un bloque se puede elegir la tarea. Guarda todo en localStorage para que siga ahí al cerrar. Enséñame el resultado en el navegador integrado y pasa las comprobaciones de la etapa 3.
ComprobaciónCreáis dos proyectos con tres tareas, recargáis la página y siguen ahí.
Si algo fallaSi los datos desaparecen al recargar, pedid a Codex que os enseñe qué guarda en localStorage y cuándo lo lee. Si el resultado no es el que esperabais, describid la diferencia o pegad una captura en el chat.
04Estadísticas

Objetivo ver adónde se va el tiempo con cifras y un gráfico.

Prompt
Etapa 4. Registra cada bloque terminado con fecha, hora, proyecto y tarea. Añade una vista de estadísticas con bloques de hoy, de esta semana y por proyecto, la racha de días seguidos y un gráfico de barras de los últimos siete días dibujado con SVG, sin librerías. Para probarlo, crea un botón temporal que genere sesiones de ejemplo de la última semana y otro que las borre. Pasa las comprobaciones de la etapa 4.
ComprobaciónCon las sesiones de ejemplo, las cifras cuadran entre sí y el gráfico tiene siete barras con día y número.
Si algo fallaSi los números no cuadran, pedid a Codex una tabla con los datos de ejemplo y el cálculo de cada cifra, paso a paso.
05Idiomas

Objetivo la misma app en catalán, castellano e inglés.

Prompt
Etapa 5. Añade un selector de idioma con català, castellano e English que cambie todos los textos visibles con los de textos.json y recuerde la elección. Busca en el código cualquier texto escrito a mano y pásalo a textos.json en los tres idiomas. Formatea fechas y números según el idioma. Pasa las comprobaciones de la etapa 5.
ComprobaciónAl cambiar de idioma no queda ningún texto en el idioma anterior, y la elección se mantiene al recargar.
Si algo fallaSi queda algún texto sin traducir, haced una captura y pegadla en el chat: Codex localiza el texto a partir de la imagen.
06Punto de recuperación y repaso

Objetivo guardar el trabajo de la sesión 1 para poder volver a este punto pase lo que pase.

Git guarda fotos del proyecto (commits). Si algo se estropea en la sesión 2, se vuelve a esta foto. Si no tenéis Git instalado, está en el apartado 11 del bloque 0.

Prompt
Etapa 6. Repasa todas las comprobaciones de las etapas 2 a 5 de proves_focus_studio.md y dime cuáles pasan. Después inicia Git en esta carpeta, crea un .gitignore que excluya node_modules y dist, y haz un commit con el mensaje «Sesión 1: temporizador, tareas, estadísticas e idiomas». Explícame cómo volver a este punto si algo se estropea.
Comprobacióngit log muestra el commit de la sesión 1 y el panel de revisión de Codex ya no marca cambios pendientes.
Si algo fallaSi Git pide nombre y correo, falta la configuración del apartado 12 del bloque 0: git config --global user.name y user.email.

Sesión 2 · Datos, instalador de Windows, landing y publicación

07Datos: exportar e importar

Objetivo que los datos se puedan guardar fuera de la app y recuperar, y cargar datos desde una hoja de cálculo.

Al empezar la sesión 2, abrid la misma carpeta en Codex y comprobad que todo sigue en su sitio:

Prompt
Resúmeme en [tu idioma] en qué punto está el proyecto según git log y proves_focus_studio.md, y arranca la app en http://localhost:8000 para comprobar que funciona. No cambies nada.
Prompt
Etapa 7. Añade en Configuración: Exportar datos (un fichero JSON con todos los datos y la configuración), Importar datos desde ese JSON e Importar desde CSV con el formato de tasques_exemple.csv. Si el fichero está mal formado, muestra un mensaje claro y no borres nada. Prueba la importación con tasques_exemple.csv y con un CSV estropeado que crees tú para la prueba. Pasa las comprobaciones de la etapa 7 y haz un commit.
ComprobaciónImportar tasques_exemple.csv crea 3 proyectos y 8 tareas, 2 de ellas hechas. El CSV estropeado da un aviso y no toca nada.
Si algo fallaSi salen tildes rotas (é), el CSV se ha leído con otra codificación: pedid a Codex que lo lea como UTF-8.
08Convertirla en app de escritorio

Objetivo que Focus Studio se abra en su propia ventana, con su icono, como un programa.

Usamos Electron, la misma tecnología de apps como VS Code o Slack: envuelve la página en una ventana de escritorio. Necesita Node.js (apartado 11 del bloque 0) y descargar paquetes, así que Codex os pedirá permiso para usar internet.

Prompt
Etapa 8. Convierte Focus Studio en app de escritorio con Electron: crea package.json (nombre focus-studio, versión 1.0.0), instala electron como dependencia de desarrollo y crea main.js con una ventana de 1000 × 700 que cargue index.html, use icona.png y no muestre la barra de menús. Asegúrate de que los textos de textos.json y los demás ficheros de datos se cargan dentro de Electron sin servidor. Añade el script start y ejecuta npm start. Pasa las comprobaciones de escritorio y haz un commit.
Para comprobarlo vosotros
node --version
npm --version
npm start
ComprobaciónSe abre una ventana «Focus Studio» con su icono, los datos de antes y los textos en el idioma elegido.
Si algo fallaSi npm no se reconoce, Node.js no está instalado o la app no se ha reiniciado después de instalarlo. Si sale «running scripts is disabled», es la política de PowerShell del apartado 06 del bloque 0. Si la ventana sale vacía, pedid a Codex que abra las herramientas de desarrollo de Electron y lea el error.
09El instalador para Windows

Objetivo un fichero Focus-Studio-Setup-1.0.0.exe que cualquiera puede instalar en Windows.

Prompt
Etapa 9. Prepara el instalador de Windows con electron-builder: instálalo como dependencia de desarrollo y añade en package.json la configuración build con appId com.cibernarium.focusstudio, productName Focus Studio, icono icona.png y destino nsis para Windows, que cree acceso directo en el escritorio y en el menú Inicio y que el fichero se llame Focus-Studio-Setup-${version}.exe. Añade el script dist (electron-builder --win) y ejecútalo. Dime dónde ha quedado el .exe y cuánto ocupa.
Generar el instalador
npm run dist

Instalar y probar

  1. Abrid la carpeta distDoble clic en Focus-Studio-Setup-1.0.0.exe.
  2. Aviso de SmartScreenWindows mostrará «Windows protegió su PC» porque la app no está firmada con un certificado de empresa. Es lo esperado en una app propia: pulsad Más información y después Ejecutar de todas formas.
  3. Instalad y abridLa instalación es para vuestro usuario y no pide permisos de administrador. Abrid Focus Studio desde el menú Inicio.
  4. DesinstalarConfiguración de Windows › Aplicaciones › Aplicaciones instaladas › Focus Studio.
Si trabajáis con MacEl instalador de Windows se genera en un PC con Windows. En el Mac, pedid a Codex el destino dmg con electron-builder --mac y obtendréis el instalador para macOS.
ComprobaciónEn dist está Focus-Studio-Setup-1.0.0.exe. Instalada, la app abre desde el menú Inicio y conserva los datos al cerrarla y abrirla.
Si algo fallaSi electron-builder falla al descargar sus herramientas, es la red: aprobad el acceso a internet que pide Codex y repetid. Si se queja del icono, pedid a Codex que compruebe que icona.png mide al menos 256 × 256.
10La landing de Focus Studio

Objetivo una página web que presente la app con su copy, una captura y el botón de descarga, con el estilo de una web de referencia.

Elegid una web cuyo diseño os guste (la de una app, un estudio o una marca) y copiad su dirección. Codex la mira en el navegador integrado, extrae el sistema visual (tipografías, colores, espacios, botones) y lo aplica a vuestra landing con textos propios. También podéis pegar una captura de la referencia en el chat.

Prompt 1 · El estilo
Etapa 10, primera parte. Abre en el navegador integrado [dirección de la web de referencia] y analiza su diseño: tipografías (busca equivalentes en Google Fonts), paleta de colores, escala de tamaños, espaciado, estilo de botones y de tarjetas. Escríbelo en docs/estil.md como un sistema propio para Focus Studio. No copies textos, logos ni imágenes de la referencia. Enséñame el resumen antes de seguir.
Prompt 2 · Copy y página
Etapa 10, segunda parte. Escribe el copy de la landing en [tu idioma] a partir de brief_focus_studio_es.md: titular, subtítulo, tres ventajas, cómo funciona en tres pasos, preguntas frecuentes y llamada a descargar. Tono claro y directo, sin exageraciones. Después crea docs/index.html con ese copy y el sistema de docs/estil.md: cabecera, captura de la app (hazla tú con el navegador integrado en http://localhost:8000 y guárdala como docs/captura.png), ventajas, pasos, botón Descargar para Windows que apunte a https://github.com/[tu usuario]/focus-studio/releases/latest/download/Focus-Studio-Setup-1.0.0.exe, preguntas y pie. Responsive, accesible y en un solo fichero de estilos. Ábrela en el navegador integrado a 1440 y a 390 px y pasa las comprobaciones de la etapa 10.

Para iterar, usad los comentarios del navegador integrado sobre la propia página («este titular más corto», «más aire entre secciones») o pedid cambios concretos en el chat.

Comprobacióndocs/index.html se ve bien en escritorio y en móvil, usa las fuentes y colores de docs/estil.md y no contiene textos ni imágenes de la referencia.
Si algo fallaSi la referencia no carga en el navegador integrado (algunas webs lo bloquean), haced una captura y pegadla en el chat con el mismo prompt. Si la captura de la app sale en blanco, arrancad antes el servidor de la etapa 2.
11Publicar: GitHub, instalador y landing en línea

Objetivo el código en GitHub, el instalador en una release y la landing publicada con su dirección pública.

Necesitáis la cuenta de GitHub y gh auth login del apartado 12 del bloque 0. GitHub Pages publica gratis la carpeta docs de un repositorio público.

Prompt
Etapa 11. Repasa todas las comprobaciones de proves_focus_studio.md y dime cuáles pasan. Crea un README.md en [tu idioma] que explique qué es Focus Studio, cómo se instala y cómo se arranca en modo desarrollo. Haz un commit, crea con gh un repositorio público llamado focus-studio en mi cuenta y súbelo. Crea una release v1.0.0 con dist/Focus-Studio-Setup-1.0.0.exe adjunto. Activa GitHub Pages desde la rama main y la carpeta /docs, espera a que esté publicada y dame la dirección. Pídeme permiso antes de cada paso que suba algo.
Comprobar en GitHub
gh repo view --web
gh release view v1.0.0
gh api repos/{owner}/focus-studio/pages
ComprobaciónLa landing está en https://vuestro-usuario.github.io/focus-studio/ y su botón descarga el instalador de la release.
Si algo fallaGitHub Pages puede tardar unos minutos en publicar la primera vez. Si el botón da error 404, la release no tiene el .exe con ese nombre exacto: pedid a Codex que lo compruebe con gh release view. Si gh dice que no estáis autenticados, repetid gh auth login.
Más allá de las apps

IA en tus apps, IA local, MCP y Blender

Cinco prácticas con el mismo formato. La primera añade reconocimiento de imágenes a Biblioteca Studio con Codex como IA, sin API. La segunda construye Biblioteca Studio desde cero como web publicada en internet y le añade la API gratuita de Gemini para reconocer portadas, contraportadas y textos. La tercera construye Arnès, una app de escritorio que descarga Gemma 4 de Hugging Face y funciona sin conexión. Las dos últimas conectan Codex con otras herramientas mediante MCP y le hacen manejar Blender para crear un modelo 3D para Cafès Roca.

00Cómo encaja la IA sin API de pago

Objetivo entender el reparto de trabajo antes de tocar la app: quién reconoce, quién pone los datos y quién guarda.

Vamos a conseguir que Biblioteca Studio añada un libro a partir de una foto de su portada: título, subtítulo, autor, año, páginas, ISBN, sinopsis y portada. Para no pagar una API de IA, la parte inteligente la hace Codex dentro de vuestro plan de ChatGPT, y los datos salen de Open Library, la base de datos pública y gratuita de libros del Internet Archive.

1 · Fotoportada del librocarpeta fotos/2 · Codexmira la imagentítulo y autor3 · Open Librarydatos y portadaAPI pública gratuita4 · La apprevisa e importallibres_detectats.jsonLa IA corre en Codex con tu plan de ChatGPT; la app solo lee datos públicos.
Codex hace el trabajo que necesita inteligencia (ver la portada y reconocer el libro). Open Library pone los datos. La app recibe un fichero y lo importa.
  1. RequisitoBiblioteca Studio hecha hasta la etapa 7 (exportar e importar datos). Si habéis construido otra app, la etapa 7 de esta práctica adapta el mismo método.
  2. Materialesbiblioteca-ia-materials.zip: formato de importación, dos libros de ejemplo, carpetas de trabajo y la skill catalogar-llibres.
  3. FotosTres o cuatro libros vuestros, fotografiados de frente con el móvil, con buena luz y el título legible.
Cuándo haría falta una API de pagoSi la app instalada tuviera que reconocer fotos sola, sin Codex, necesitaría la API de OpenAI (se paga por uso) y un pequeño servidor que guarde la clave: una clave dentro de un .exe la puede leer cualquiera. Aquí lo evitamos porque el reconocimiento lo hacéis desde Codex.

→ Open Library · APIs · Image inputs (OpenAI)

ComprobaciónSabéis decir qué parte hace Codex, qué parte Open Library y qué parte la app.
Si algo fallaSi vuestra Biblioteca Studio todavía no importa JSON, haced antes su etapa 7.
01La app busca en Open Library (sin IA)

Objetivo que el formulario de libro se rellene solo a partir del título, el autor o el ISBN.

Primero, la parte que no necesita IA: la propia app consulta Open Library. Es gratis, no pide clave y responde desde el navegador y desde Electron.

Prompt
Etapa IA-1. Añade a cada libro los campos subtítulo, año, ISBN, sinopsis, portada (ruta local o URL) y fuente de los datos, con sus textos en textos.json (ca, es, en). En el formulario de nuevo libro añade el botón «Buscar en Open Library»: con lo que haya escrito en título, autor o ISBN, llama una sola vez a https://openlibrary.org/search.json con fields=key,title,subtitle,author_name,first_publish_year,cover_i,isbn,number_of_pages_median y limit=5, y muestra los resultados con miniatura (https://covers.openlibrary.org/b/id/{cover_i}-M.jpg), título, autor y año. Al elegir uno, rellena el formulario; para la sinopsis, pide https://openlibrary.org{key}.json y usa description si existe. Guarda la URL grande de la portada (-L.jpg). Nunca busques mientras se escribe, solo al pulsar el botón, y muestra un mensaje claro si no hay conexión o no hay resultados. Pruébalo con «Mecanoscrit del segon origen» y haz un commit.

→ Open Library · Search API · Open Library · Covers API

ComprobaciónAl buscar «Mecanoscrit del segon origen» sale Manuel de Pedrolo, 1974, con portada; al elegirlo se rellenan título, autor, año, páginas e ISBN. Muchos libros no tienen sinopsis en Open Library: lo resolverá Codex en la etapa 3.
Si algo fallaSi no sale nada, probad en el navegador integrado la dirección https://openlibrary.org/search.json?q=mecanoscrit para ver si responde. Open Library pide no hacer más de una consulta por segundo: si se buscaba a cada tecla, pedid a Codex que lo cambie al botón.
02Carpetas de trabajo e importación

Objetivo preparar el buzón de fotos y que la app importe los libros que le deje Codex, sin duplicados.

  1. Descomprimid los materialesCopiad el contenido de biblioteca-ia-materials.zip dentro de la carpeta de Biblioteca Studio (la que tiene index.html). Quedan fotos/, fotos/fetes/, portades/, importar/, format_importacio.md y .agents/skills/catalogar-llibres/.
  2. Importación en la appCon el prompt de abajo.
Prompt
Etapa IA-2. Lee format_importacio.md. Añade en Configuración el botón «Importar libros detectados», que abra un fichero JSON con ese formato y muestre una vista previa: portada, título, autor, confianza, avisos y una casilla por libro (los de confianza baja, desmarcados). Al confirmar, añade solo los marcados y salta los que ya existan (mismo ISBN, o mismo título y autor sin distinguir mayúsculas ni acentos). Para la portada, usa la ruta local si el fichero existe y, si no, portada_url. Pruébalo con importar/llibres_detectats_exemple.json, importándolo dos veces, y haz un commit.

Si no podéis descargar el zip, cread los ficheros con estos prompts

format_importacio.mdEl formato del fichero que escribe Codex.
Crear este fichero con un prompt
Prompt
Crea format_importacio.md con el formato de importar/llibres_detectats.json: un objeto con generat (fecha ISO) y llibres, una lista de libros con titol, subtitol, autor, any, pagines, isbn, genere, sinopsi, portada (ruta local), portada_url, estat (pendent por defecto), confianca (alta, mitjana o baixa), avis, font (dades, sinopsi y la URL de Open Library) y foto. Añade un ejemplo, una tabla de campos y las reglas de duplicados (mismo ISBN, o mismo título y autor).
importar/llibres_detectats_exemple.jsonDos libros reales para probar la importación.
Crear este fichero con un prompt
Prompt
Crea importar/llibres_detectats_exemple.json con el formato de format_importacio.md y dos libros buscados ahora en Open Library: «Mecanoscrit del segon origen» de Manuel de Pedrolo y «Solitud» de Víctor Català, con sus datos, portada_url y una sinopsis de dos frases. Si algún dato de Open Library no coincide con la primera edición, explícalo en avis y pon confianca mitjana. Pídeme permiso antes de usar internet.
fotos/ · fotos/fetes/ · portades/ · importar/Las carpetas de trabajo.
Crear este fichero con un prompt
Prompt
Crea las carpetas fotos, fotos/fetes, portades e importar en este proyecto, cada una con un fichero .gitkeep, y añade fotos/ y portades/ al .gitignore para no subir fotos personales a GitHub.
ComprobaciónLa vista previa muestra Mecanoscrit marcado y Solitud con su aviso sobre el año. Al importar el fichero por segunda vez no se duplica nada.
Si algo fallaSi las portadas no se ven, la app está buscando la ruta local de un fichero que no existe: en el ejemplo la portada local está vacía y tiene que usar portada_url. Si la carpeta .agents no aparece en el Mac, Cmd+Mayús+. en el Finder.
03Codex reconoce las portadas

Objetivo pasar de unas fotos del móvil a un fichero de libros completo, con Codex como la IA que mira las imágenes.

  1. Haced las fotosDe frente, con luz, sin reflejos y con el título entero. Si se ve el ISBN en la contraportada, una segunda foto ayuda.
  2. Pasadlas al ordenadorCon la app Enlace Móvil de Windows, la cámara de OneDrive, por correo o con el cable. Guardadlas en fotos/.
  3. Pedídselo a CodexCodex mira cada imagen, consulta Open Library y escribe el fichero. Pedirá permiso para usar internet: es para Open Library, aprobadlo.
Prompt
Etapa IA-3. Mira una a una las imágenes de fotos/ e identifica en cada portada el título, el subtítulo si lo hay, el autor y, si se ve, el ISBN. Para cada libro, haz una sola búsqueda en https://openlibrary.org/search.json (por ISBN si lo tienes; si no, por title y author) con fields=key,title,subtitle,author_name,first_publish_year,cover_i,isbn,number_of_pages_median, con la cabecera User-Agent «BibliotecaStudio-curs» y un segundo de espera entre peticiones. Usa description de https://openlibrary.org{key}.json como sinopsis; si no existe, redacta tú una de dos o tres frases sin desvelar el final y pon Codex como fuente. Descarga la portada a portades/{cover_i}.jpg. Escribe importar/llibres_detectats.json con el formato de format_importacio.md, mueve las fotos procesadas a fotos/fetes/ y acaba con una tabla: foto, título, autor, confianza, fuente de la sinopsis y avisos. No inventes ISBN, años ni páginas. Pídeme permiso antes de usar internet.
Una foto suelta, sin carpetaTambién podéis arrastrar la foto al chat de Codex con Mayús pulsada y pedir: «Añade este libro a importar/llibres_detectats.json siguiendo format_importacio.md».

→ Image inputs (OpenAI) · Sandbox y red (OpenAI)

ComprobaciónExiste importar/llibres_detectats.json con un libro por foto, las portadas están en portades/, las fotos han pasado a fotos/fetes/ y la tabla final dice de dónde sale cada sinopsis.
Si algo fallaSi Codex no reconoce un libro, la foto está movida o con reflejos: repetidla o escribid el título en el chat. Si no puede conectar, comprobad que aprobasteis el acceso a internet; en config.toml, [sandbox_workspace_write] network_access = true lo deja activado. Si confunde ediciones, pedidle que use el ISBN de la contraportada.
04Revisar e importar

Objetivo que una persona decida qué entra en la biblioteca: la IA propone y vosotros aprobáis.

  1. Abrid la importaciónConfiguración › Importar libros detectados › importar/llibres_detectats.json.
  2. Revisad los avisosLos datos públicos también fallan: años de una reedición, autores de un prólogo, subtítulos de otra edición. Corregid antes de importar o desmarcad el libro.
  3. ImportadSolo los marcados. Después abrid una ficha y comprobad portada, sinopsis y fuente.
Prompt
Revisa importar/llibres_detectats.json y dime en [tu idioma] qué datos te parecen dudosos (años de reedición, autores que en realidad son traductores o prologuistas, subtítulos que no corresponden) y por qué. No cambies nada hasta que te lo diga.
ComprobaciónLos libros nuevos aparecen en la lista con su portada, y la ficha muestra la sinopsis y su fuente (Open Library o Codex).
Si algo fallaSi un libro se duplica, el título difiere en un acento o una mayúscula: pedid a Codex que revise la comparación de duplicados de la etapa IA-2.
05Una skill: $catalogar-llibres

Objetivo repetir todo el proceso con una sola palabra, sin volver a pegar el prompt.

Una skill es un fichero SKILL.md con instrucciones que Codex carga cuando las necesita. Las del proyecto viven en .agents/skills/. El zip ya trae catalogar-llibres; si no lo tenéis, Codex la crea con $skill-creator.

Si no tenéis la skill del zip
$skill-creator Crea en .agents/skills/catalogar-llibres una skill llamada catalogar-llibres a partir de lo que hemos hecho en la etapa IA-3: leer las fotos de fotos/, reconocer título y autor, buscar en Open Library con una petición por libro y User-Agent, sinopsis de Open Library o redactada por ti con la fuente indicada, portada en portades/, salida en importar/llibres_detectats.json según format_importacio.md sin duplicados, fotos a fotos/fetes/ y tabla final. Que se active solo cuando pida catalogar libros a partir de fotos.
Comprobar y usar
/skills
$catalogar-llibres

→ Build skills (OpenAI)

Comprobación/skills lista catalogar-llibres. Con fotos nuevas en fotos/, escribir $catalogar-llibres repite todo el proceso y amplía el fichero sin duplicar.
Si algo fallaSi la skill no aparece, revisad que la ruta sea exactamente .agents/skills/catalogar-llibres/SKILL.md dentro del proyecto abierto y empezad un chat nuevo: las skills se cargan al empezar.
06Opcional: que se haga solo cada día

Objetivo dejar fotos en la carpeta y encontrar al día siguiente el fichero listo para importar.

Las tareas programadas de la app de ChatGPT ejecutan un prompt en un horario, también dentro de un proyecto local, y pueden usar skills. El ordenador tiene que estar encendido y la app abierta; la disponibilidad depende del plan.

Prompt
Crea una tarea programada en este proyecto que cada día a las 9:00 ejecute $catalogar-llibres solo si hay fotos nuevas en fotos/, y que si no hay ninguna termine sin hacer nada. Dime dónde la veré.

→ Automations (OpenAI)

ComprobaciónLa tarea aparece en Scheduled, en la barra lateral de la app, con su próxima ejecución.
Si algo fallaSi se para esperando permiso para usar internet, nadie lo aprueba de madrugada: activad network_access = true en config.toml solo para este proyecto o ejecutadla a una hora en la que estéis delante.
07El mismo método en las otras apps

Objetivo aplicar el patrón foto → Codex → datos públicos → importación a la app que hayáis construido.

AppFotoDatos públicosQué rellena
Focus StudioCaptura de un correo o de una lista de tareasNinguna: Codex lee el textoProyecto, tareas y estimación de bloques
Astronomia StudioFoto del cielo o de una carta celesteAPI de resúmenes de WikipediaObjeto, tipo y una nota con su descripción
QR StudioFoto de un cartel o de un folletoNinguna: Codex lee el texto y la direcciónCampaña con título, texto, URL y fechas
Hort StudioFoto de una planta o de un sobre de semillascultius.json del propio proyectoCultivo, bancal y fecha de siembra
Col·leccions StudioFoto de la portada de un discoMusicBrainz y Cover Art ArchiveTítulo, artista, año, género y portada
Rutes StudioFoto de un poste o de un panel de senderoNominatim de OpenStreetMapNombre, zona y coordenadas del inicio
Prompt
Quiero aplicar a esta app el método de la práctica de IA de Biblioteca Studio: fotos en fotos/, Codex reconoce lo que hay en cada imagen, completa los datos con [base de datos pública o fichero del proyecto] y escribe importar/detectats.json para que la app lo importe con vista previa y sin duplicados. Propón en [tu idioma] el formato del fichero, los cambios en la app y la skill, en etapas como las de Biblioteca. Comprueba antes en la documentación oficial de esa base de datos sus límites de uso. No cambies nada todavía.
ComprobaciónCodex propone un plan en etapas para vuestra app, con el formato del fichero y los límites de la fuente de datos.
Si algo fallaSi la base de datos pide clave o registro, elegid otra o usad solo lo que Codex reconoce en la imagen.
Después del curso

El mismo método para tu propia app

Repetid el proceso con una idea vuestra. Empezad siempre por un brief, un AGENTS.md y una lista de comprobaciones, y construid por etapas.

Prompt para empezar una app nueva
Quiero crear una app de escritorio para [tu idea]. Hazme las preguntas necesarias y, con mis respuestas, crea un brief.md con objetivo, usuarios, funciones, aspecto, fuera de alcance y cómo comprobarlo; un AGENTS.md con normas de trabajo como las de este curso; y un proves.md con las comprobaciones por etapa. Después propón el plan en doce etapas, de la carpeta a la publicación. No escribas código todavía.
Preguntas

Antes de apuntarte

¿Necesito saber programar?

No. Necesitáis manejar carpetas y un navegador. Codex escribe el código; vosotros decidís, aprobáis y comprobáis.

¿Qué app elijo?

La que os resulte útil. Si dudáis, Focus Studio: es la que se demuestra en pantalla. Todas tienen la misma dificultad.

¿Qué cuenta necesito?

Funciona con el plan gratuito de ChatGPT (GPT-6 Luna). Con Plus tendréis GPT-6.1 Sol y más margen de uso. Computer Use depende de la región y de la cuenta.

¿Y si tengo Mac?

Todo funciona igual. En la etapa 9 obtendréis un instalador para macOS; el de Windows se genera en un PC con Windows.

¿Necesito permisos de administrador?

No para instalar vuestra app. Para instalar Codex, Git, Node.js o Blender en un ordenador de empresa puede que sí: revisadlo antes con informática.

¿Qué pasa si me quedo atrás?

Cada etapa empieza desde la anterior y el commit de la etapa 6 permite retomar la sesión 2 desde un punto seguro.

Libros

Libros para trabajar con IA

Guías prácticas escritas a partir de mis cursos, con los mismos casos y prácticas paso a paso. Los publicados están en Amazon, en Kindle y en tapa blanda. Los que aún no han salido enlazan al temario del curso.