First run on free models

No se necesita una clave de pago para probar Perfica. La primera pantalla de la guía de configuración hace una pregunta: Start free o I have a key.

Start free

Start free configura los modelos gratuitos en unos dos minutos. Pide dos claves gratuitas, cada una creada en el sitio del propio proveedor, y ninguna necesita una tarjeta:

• OpenRouter. Iniciar sesión en openrouter.ai, pulsar Create Key y copiar la clave que muestra una sola vez.
• Google Gemini. Iniciar sesión con una cuenta de Google en aistudio.google.com, pulsar Create API key y copiarla.

Pegar cada clave en su fila y pulsar Save. Las claves se quedan en el computador. Una clave basta para empezar; con ambas, Perfica pasa al otro proveedor cuando el primero se agota por el día.

Al pulsar Continue, Perfica agrupa los modelos gratuitos en un pool, Free models, y lo define como el modelo por defecto. Cada bubble colocada empieza en él, al igual que el Manager. El pool contiene:

• Laguna S 2.1 y Nemotron 3 Ultra en OpenRouter. Estos son los modelos gratuitos que la comprobación de modelos propia de Perfica encontró usando sus herramientas correctamente.
• Gemini 3.8 Flash y Gemini 3.5 Flash-Lite en la capa gratuita de Google.

Start free se encuentra en Settings (el engranaje, arriba a la derecha) › APIs › Free models, y en la solicitud de clave del modo simple, si se omite ahora.

The rest of the walkthrough

1. Language. El idioma en el que se muestra la aplicación, cuando ofrece más de uno.
2. A model. Start free o I have a key: añadir una clave para un proveedor que ya se paga (o elegir un ejecutor local) y seleccionar el default model. Consultar Add a provider key.
3. Your first loop. Darle un nombre, elegir una forma inicial y seleccionar la carpeta de proyecto en la que trabaja. La carpeta es opcional, pero sin ella los agentes pueden hablar con los modelos pero no tocar archivos. Si la carpeta aún no es un repositorio git, la guía indica que Perfica la convertirá en uno.
4. The Manager. Elegir el modo en el que se abre el chat.

A first loop that works

El primer loop es una idea propia:

1. Abrir el Manager en Plan y describir lo que se quiere, en una o dos frases.
2. Responder a sus preguntas. En modelos gratuitos, el Manager planifica una primera versión pequeña, de un máximo de cinco tarjetas, que pueda ejecutarse de principio a fin hoy mismo, y dice lo que deja para más adelante. Una vez de acuerdo, escribe las tarjetas en el Task Book como Approved.
3. Cambiar a Build. El Manager propone un loop con dos o tres bubbles; pulsar Build it.
4. Pulsar Play. Ver a los bubbles turnarse; la pestaña Log del Manager muestra cada pasada.

When a free tier runs out

Las capas gratuitas permiten unas pocas docenas de solicitudes al día. Cuando una se agota en medio de un run:

1. Perfica pasa al otro proveedor gratuito, si se añadieron ambas claves.
2. Cuando ambas se agotan, el loop se pausa donde se detuvo y un aviso indica cuándo lo intentará de nuevo. No se cuenta ningún error y no se pierde nada.
3. El loop vuelve a empezar por sí solo: a la hora que da el proveedor para su restablecimiento, o si no tras 5, 10, 20 y 40 minutos y luego cada hora. Sigue intentándolo mientras se deje el tablero sin tocar, de modo que un run dejado durante la noche continúa cuando vuelve la asignación. Pausar o detener el loop detiene los reintentos.
4. El aviso tiene un botón Add a paid key, y Play lo intenta de nuevo de inmediato.

Perfica sigue funcionando mientras su ventana está cerrada, desde la bandeja del sistema. Salir de la aplicación detiene los reintentos; pulsar Play al abrirla de nuevo.

Smaller models

Los modelos gratuitos y locales son más pequeños que los de frontera de pago. Hay que darles tarjetas pequeñas y bien descritas, y mantener un loop corto al principio. Se puede mover un solo bubble a un modelo más potente más tarde sin cambiar el resto.