Self-hosted

Primer equipo y primer run

Conecta los agentes, crea tu equipo y lleva la primera issue hasta un PR.

Con la GitHub App lista, quedan tres cosas: un login para los agentes, tu equipo y una issue.

Dale un login a los agentes

Un agente necesita un login. Hay dos formas, y puedes usar las dos.

Cada equipo conecta el suyo desde Factory › Conexiones › Modelos: Claude o ChatGPT, con suscripción o con API key. Es la forma de hacerlo cuando varios equipos comparten la instalación. No hace falta reiniciar nada.

Dale una clave al chat

El chat es un agente que lee la factory y propone cambios. Lo paga quien opera la instalación. Pon en .env la clave del modelo que quieras:

FORJA_ASSISTANT_API_KEY=sk-ant-...
FORJA_ASSISTANT_PROVIDER=anthropic   # anthropic, openai, openrouter u openai_compatible
FORJA_ASSISTANT_MONTHLY_CAP_USD=20   # tope por equipo y mes; none para no limitar

Sin clave, el chat usa el login de Claude de la instalación si existe y, si no, responde con frases fijas: sigue guiando el alta, pero no entiende peticiones abiertas.

Crea tu equipo

Abre tu dirección y entra con la cuenta de GitHub cuyo email está en FORJA_ADMIN_EMAILS. Aún no tienes equipo: créalo con un nombre. Eres su propietario.

Instala la app para tu equipo

Si no lo hiciste al crearla, abre https://forjar.example.com/api/github/install con la sesión iniciada. La instalación queda vinculada a tu equipo.

Monta la factory

En Chat › Nueva factory di qué repositorio: «monta una factory para owner/nombre». Confirma la propuesta.

Dale una issue

Abre una issue en ese repositorio y ponle la etiqueta forja (FORJA_TRIGGER_LABEL). En segundos el worker la toma: planifica, trabaja en un sandbox, sube una rama forja/… y abre un PR que verás en la cabina.

Más equipos

Otros equipos entran con un enlace, sin editar nada:

docker compose exec api node dist/app/admin/access-main.js invite --label "Acme"

Imprime un enlace de cuenta. status muestra en qué paso está cada equipo: invitado, cuenta creada, equipo creado, repositorio conectado, primer PR mergeado. Para que esos enlaces abran cuenta, pon FORJA_SIGNUP=invite.

Tus compañeros de equipo entran con un enlace que crea un propietario en Factory › Equipo.