altero
altero es un servidor de sincronización self-hosted para Zotero, que mantiene bibliotecas, grupos, notas y adjuntos en su propia infraestructura usando la API web sin modificar el cliente.
Ficha actualizada 23 sept 2026, 17:39 · upstream 23 sept 2026, 17:37 · release sin release detectada
Qué es altero
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
altero es un servicio de sincronización propio para Zotero. Permite mantener las bibliotecas, grupos, notas, anotaciones, archivos adjuntos y texto completo en una infraestructura que se controla. Es más que WebDAV porque ofrece datos y archivos de sincronización además de los archivos adjuntos. No requiere caché, cluster de búsqueda ni almacenamiento de objetos. Los adjuntos viven en un directorio normal, por lo que la copia de seguridad es una copia del banco de datos junto con ese directorio.
altero se diferencia de zotero.org porque ofrece: - Autenticación institucional con OpenID Connect o SAML 2.0 - Acceso escalonado para aplicaciones externas mediante OAuth 2.0 y OpenID Connect - Permisiones más finas por grupo (solo lectura, añadir sin eliminar, editar solo tu contenido) - Enlaces compartidos de colecciones - Notificaciones sobre cambios en grupos - Renombrado de etiquetas a nivel del servidor - Reportes de retención y almacenamiento - Migración desde zotero.org que conserva claves de objetos y versiones
El proyecto está en desarrollo activo. No se recomienda usarlo como único repositorio para una biblioteca importante.
- Mantener bibliotecas personalizadas fuera del servicio oficial de Zotero
- Servir bibliotecas a instituciones con autenticación institucional (OpenID Connect/SAML)
- Permitir acceso escalonado a aplicaciones externas mediante OAuth 2.0
- Gestionar permisos granulares por grupo más allá de owner y member
- Crear enlaces compartidos de colecciones sin necesidad de un account completo
- Monitorear actividad en grupos y notificaciones sobre cambios
- Renombrar etiquetas a nivel del servidor para evitar conflictos
- Reportar retención de objetos y uso real de almacenamiento
- Es un servicio self-hosted completo: servidor, base de datos y almacenamiento de adjuntos separados
- Soporta PostgreSQL como base de datos con opción de SQLite para instalaciones locales
- Ofrece autenticación institucional (OpenID Connect y SAML 2.0) que no está disponible en zotero.org
- Proporciona acceso escalonado mediante OAuth 2.0, permitiendo a aplicaciones externas obtener tokens expiratorios por colección
- Permite permisos granulares por grupo: solo lectura, añadir sin eliminar o editar solo tu contenido
- Soporta múltiples idiomas (15 catálogos) y traducciones de la interfaz web
- No requiere parches en el cliente de Zotero; la API se reproduce tal como existe en zotero.org
- Ofrece migración desde zotero.org que conserva claves de objetos y versiones
- No soporta las aplicaciones móviles iOS ni Android, ya que compilan la API en el cliente y no ofrecen preferencias para reemplazarla
- El cliente Desktop requiere un parche oculto para ambos la API y el servidor de streaming
- Zotero no respalda oficialmente servidores terceros; altero se usa como alternativa pero no es el único repositorio
- La migración desde zotero.org puede perder datos si no se configuran correctamente las claves de objetos
- No incluye un cliente web nativo para Zotero, solo una interfaz en navegador
- El almacenamiento de adjuntos depende del sistema operativo y del disco local del servidor
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para usar altero con Docker Compose: crea un directorio, copia el archivo compose.yaml desde GitHub, ejecuta `docker compose up -d` y luego usa `altero user add <username>` para crear la cuenta sin contraseña. El servidor predeterminadamente se publica en localhost:8000 y consume aproximadamente 125 MB de RAM. Para producción, instala un terminador TLS o proxy (como Nginx) delante del servicio y establece una contraseña real en PostgreSQL. Para instalar desde el repositorio local necesitas Python 3.14+ y la herramienta uv: `uv sync`, `cp config.example.py config.py` y `uv run alembic upgrade head`. La base de datos predeterminada es SQLite, pero puedes migrar a PostgreSQL con `alembic upgrade head`. Para conectar Zotero Desktop, en el editor de configuración abre "Extensions → Zotero API" y pon `http://localhost:8000/`, y en "Streaming" pon `ws://localhost:8000/stream`. Inicia altero,
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.