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 limitarSin 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.