Documentación

Ejecuta Pulsyr y conecta tu primer agente.

La ruta más rápida usa Docker Compose y la imagen publicada. Necesitas Docker, un secreto de aplicación generado y una contraseña de base de datos.

Antes de producción: elige secretos únicos, usa HTTPS, mantén DEBUG=false y organiza respaldos de la base de datos.

1. Obtén el proyecto Compose

git clone https://github.com/rlcuevas14/PULSYR
cd PULSYR
cp .env.example .env

El archivo Compose inicia Pulsyr y Postgres con soporte para pgvector. Puede compilar localmente o usar la imagen configurada para el repositorio.

2. Configura los secretos requeridos

SECRET_KEY=<un valor aleatorio de al menos 32 caracteres>
DB_PASSWORD=<una contraseña única para la base de datos>
DEBUG=false

Genera el secreto de la aplicación con una herramienta criptográficamente segura. Pulsyr se niega a iniciar en producción con un valor de ejemplo o demasiado corto.

3. Inicia los servicios

docker compose up -d

Abre el host configurado. Una base nueva redirige a /setup, donde crearás la cuenta propietaria, el primer proyecto y un token de escritura. El token se muestra una vez: guárdalo en la configuración secreta del cliente MCP.

4. Conecta un cliente compatible con MCP

Todos los clientes necesitan el endpoint y el encabezado Bearer:

URL:        https://tu-host-pulsyr.example/mcp
Encabezado: Authorization: Bearer <TOKEN_DEL_PROYECTO>

Para Claude Code, la configuración del proyecto entrega un comando listo para copiar. Otros clientes usan la misma URL y el mismo encabezado en su propia configuración.

5. Verifica el contexto del proyecto

Reinicia el cliente si es necesario y pídele invocar pulsyr_context. Una respuesta válida contiene proyecto, prioridades, bloqueos, incidentes e hilos activos. Si falla la autenticación, crea un token nuevo en Configuración del proyecto.