Inicio rápido: alojamiento propio
Corre el motor de código abierto de Sypnia en tu propia máquina con Docker, crea un proyecto y mira tu primera sesión y tu primer problema.
Motor Esta página es para quien quiere correr Sypnia por su cuenta. Arranca el motor de código abierto en tu propia máquina con Docker, junto a su base de datos y su almacenamiento, para que pruebes todo antes de elegir dónde va a vivir. Si prefieres no correr servidores, usa el inicio rápido de Sypnia Cloud; el fragmento en tu app es el mismo.
Al final tendrás: el motor corriendo en http://localhost:8080, un proyecto con sus llaves, tu app enviándole datos, y tu primera sesión y tu primer problema en la Consola.
Necesitas: Docker con Compose, una app web que puedas editar y correr en la misma máquina, y unos quince minutos.
Escribe el archivo de Compose
En una carpeta vacía, crea este archivo. Arranca tres cosas: el motor, un Postgres para los números, y MinIO como bucket compatible con S3 para los eventos crudos y las grabaciones.
compose.yaml services: sypnia: image: ghcr.io/sypnia/sypnia:1 ports: ["8080:8080"] environment: SYPNIA_BASE_URL: http://localhost:8080 SYPNIA_ROOT_TOKEN: change-me-to-a-long-random-string SYPNIA_AUTO_MIGRATE: "true" SYPNIA_DATABASE_URL: postgres://sypnia:sypnia@db:5432/sypnia SYPNIA_STORAGE_BUCKET: sypnia SYPNIA_STORAGE_ENDPOINT: http://minio:9000 SYPNIA_STORAGE_PUBLIC_ENDPOINT: http://localhost:9000 SYPNIA_STORAGE_PATH_STYLE: "true" SYPNIA_STORAGE_ACCESS_KEY_ID: sypnia SYPNIA_STORAGE_SECRET_ACCESS_KEY: sypnia-secret depends_on: db: { condition: service_healthy } bucket: { condition: service_completed_successfully } db: image: postgres:16 environment: POSTGRES_USER: sypnia POSTGRES_PASSWORD: sypnia POSTGRES_DB: sypnia volumes: ["db:/var/lib/postgresql/data"] healthcheck: test: ["CMD-SHELL", "pg_isready -U sypnia"] interval: 2s retries: 30 minio: image: minio/minio command: server /data ports: ["9000:9000"] environment: MINIO_ROOT_USER: sypnia MINIO_ROOT_PASSWORD: sypnia-secret volumes: ["bucket:/data"] bucket: image: minio/mc depends_on: [minio] entrypoint: > sh -c "until mc alias set local http://minio:9000 sypnia sypnia-secret; do sleep 1; done; mc mb --ignore-existing local/sypnia" volumes: db: bucket:Cada línea
SYPNIA_…es un ajuste del motor, explicado en la referencia de configuración. El motor no necesita nada más: ni cola, ni caché, ni servidor de búsqueda.Revisa la instalación
Terminal docker compose exec sypnia sypnia doctor --skip aiDeberías verText config ok 10 settings read, 0 unknown database ok postgres 16.4, schema 12 (up to date), 2 ms storage ok s3://sypnia: put, get, delete, presign address ok http://localhost:8080/healthz answered 200 webhook skip SYPNIA_ALERT_WEBHOOK_URL is not set (alerts are recorded only) clock ok 0.1 s from the database's clock all checks passedUna línea que dice
FAILnombra el ajuste que hay que cambiar. El chequeo de IA se omite porque todavía no hay una llave de modelo: el motor funciona sin ella, y los problemas conservan entonces su título técnico. Cómo conectar un modelo está en Modelos y qué se envía.Crea un proyecto y un token
Terminal docker compose exec sypnia sypnia project create --name ShopDeberías verText project shop (prj_5k2m9x4q7w1z) ingest key spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e Put the ingest key in your app. It is public: it can only send. Next: sypnia token create --project shop --name "My laptop" --scopes read,replayLa llave de ingesta va en tu app. Para leer lo que llega necesitas un token de API:
Terminal docker compose exec sypnia sypnia token create --project shop --name "My laptop" --scopes read,replayDeberías verUna línea que empieza porsps_. Se muestra una sola vez: cópiala ahora. Es un secreto.Agrega el SDK a tu app
npm
npm install @sypnia/browserimport { init } from '@sypnia/browser'; init({ project: 'YOUR_PROJECT_KEY' });pnpm
pnpm add @sypnia/browserimport { init } from '@sypnia/browser'; init({ project: 'YOUR_PROJECT_KEY' });yarn
yarn add @sypnia/browserimport { init } from '@sypnia/browser'; init({ project: 'YOUR_PROJECT_KEY' });bun
bun add @sypnia/browserimport { init } from '@sypnia/browser'; init({ project: 'YOUR_PROJECT_KEY' });script tag
<script async src="https://ingest.sypnia.com/v1/sdk.js" data-project="YOUR_PROJECT_KEY"></script>Sin paso de compilación y sin llamar a
init: pégala antes de</head>. La etiqueta inicia Sypnia con la llave que va endata-project.Pon la llamada a
initdonde arranca tu app, antes de que pinte. Usa tu propia llave de ingesta, y apunta el SDK a tu motor conendpoint:src/main.ts import { init } from '@sypnia/browser'; init({ project: 'spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e', endpoint: 'http://localhost:8080', environment: location.hostname === 'localhost' ? 'development' : 'production', });Con la etiqueta script, cárgala desde tu motor:
src="http://localhost:8080/v1/sdk.js"ydata-endpoint="http://localhost:8080".endpointes la única diferencia con Sypnia Cloud. El SDK es el mismo paquete.Abre tu app y comprueba que envía
Corre tu app, ábrela en un navegador y haz clic en varias cosas. Abre las herramientas de desarrollo, pestaña Network, y escribe
ingesten el filtro.Deberías verEn menos de 10 segundos, unPOSTahttp://localhost:8080/v1/ingest/eventscon estado200y una respuesta como{"accepted": 5, "dropped": 0}.Causa tu primer problema, y míralo
Agrega una línea después de
init, guarda y recarga tu app una vez. Luego quítala.src/main.ts import { init, reportError } from '@sypnia/browser'; // después de init({ … }) reportError(new Error('Sypnia test: the cart total is missing'));Abre la Consola en
http://localhost:8080/console, pega tu token de API y elige el entornodevelopment.Deberías verEn menos de 2 minutos, un problema:Error: Sypnia test: the cart total is missing, 1 persona, 1 ocurrencia. En menos de 10 minutos, tu sesión, con las páginas que abriste y en qué hiciste clic. Cuando la sesión lleve 2 minutos inactiva, su grabación se reproduce en la Consola: el error inició la grabación.Lo mismo desde la línea de comandos:
Terminal docker compose exec -e SYPNIA_API_TOKEN=<tu token sps_> sypnia sypnia problems --environment development
Lo que tienes, y lo que no
| Motor de SypniaCódigo abierto, en tu propia infraestructura | Sypnia CloudServicio pago, con un plan gratis | |
|---|---|---|
| Recibir, guardar, agrupar en problemas, sesiones, grabaciones | Corriendo en tu máquina. | El mismo motor, que corremos nosotros. |
| Dónde lo lees | La Consola (problemas y grabaciones), la API, el CLI y el servidor MCP. | La app completa. |
| La frase en palabras simples y el prompt | Después de que pones tu propia llave de modelo. | Incluidos. |
| Alertas | Se registran, y se envían a un webhook si pones uno. Sin correo en el despliegue por defecto. | Correo y dentro de la app. |
| Pull requests | No están en el motor. Usa el prompt o MCP con tu propio agente de código. | Los abre la GitHub App de Sypnia. |
La comparación completa está en Código abierto y Sypnia Cloud.
Sigue con esto
| Para tener | Haz |
|---|---|
| Un despliegue al que otros puedan llegar, con HTTPS | Desplegar con Docker o Desplegar en AWS |
| La frase en palabras simples | Pon una llave de modelo: Modelos y qué se envía |
| Un correo cuando algo se rompe | Correos de alerta desde un motor con alojamiento propio |
| Tu agente de código leyendo los problemas | Instalar con tu agente de código |
| El ciclo completo una vez, con un clic de rabia y una grabación | Tu primer problema |
| Los nombres de tus archivos en las pilas | Source maps en CI |
Para detener la prueba: docker compose down. Agrega -v para borrar también sus datos.