Preguntas frecuentes

Todo lo que nos han preguntado suficientes veces como para escribirlo. Si tu pregunta no está aquí, abre un issue y la agregamos.

Última actualización: 2026-04-25.

Para empezar

¿Cómo instalo la app en mi teléfono?

Rastrum es una Progressive Web App (PWA), no una app nativa — no hay nada que instalar desde una tienda.

• Android (Chrome / Edge / Brave): abre rastrum.org; un botón "Instalar" aparece en la esquina inferior derecha. Tócalo. El icono aterriza en tu pantalla de inicio y se comporta como cualquier otra app.
• iOS (Safari): Apple no muestra un prompt automático. Abre rastrum.org, toca el icono Compartir, luego Agregar a pantalla de inicio. El icono aparece junto a las otras apps.
• Escritorio: el mismo botón de instalar aparece en Chrome/Edge/Brave a la derecha de la barra de direcciones.

Un wrapper iOS nativo en App Store está en el roadmap v1.2 (requiere cuenta de Apple Developer); la PWA cubre la mayoría de los casos de uso por ahora.

¿Necesito una cuenta?

No. Rastrum tiene modo invitado: abre el sitio, toca el botón de cámara, registra una observación. Se queda en tu dispositivo hasta que inicies sesión.

Iniciar sesión (enlace mágico, Google, GitHub, passkey, o código OTP de 6 dígitos) te da:

• Sincronización a la nube — las observaciones viven en tu cuenta y sobreviven a un reinicio del teléfono.
• Compartir — otros pueden ver y comentar tus observaciones.
• Feed de actividad e insignias.
• Tokens API para acceso programático.

Un flujo "convertir invitado a cuenta" corre la primera vez que inicias sesión: cualquier observación local se asocia a tu nueva cuenta.

¿Es gratis?

Sí. No hay cuotas de suscripción, no hay anuncios, no hay upsells. Los datos que aportas se publican bajo la licencia Creative Commons por registro que tú elijas (BY 4.0 por defecto).

Identificación

¿Por qué no veo sugerencias de identificación?

Las razones más comunes:

• No hay clave de PlantNet configurada. Inicia sesión, ve a Perfil → Editar y agrega una clave gratis de PlantNet (my.plantnet.org/account). Sin una clave, la cascada salta PlantNet y cae a plugins más lentos / opt-in.
• Cascada solo offline. Si estás offline y no tienes modelos on-device descargados, la cascada no tiene nada que correr. Aún puedes registrar la observación sin ID; la cascada vuelve a correr al sincronizar.
• Foto muy oscura / borrosa / recortada. Identificadores como PlantNet fallan en silencio en fotos sin sujeto reconocible. Toma de nuevo más cerca o con mejor luz.

¿Qué tan precisa es la identificación?

Depende del taxón y la foto:

• Plantas — la top-1 de PlantNet en la cascada acierta ~70-90% del tiempo en una foto clara de una flor o hoja, menos para fotos de hábito o frutos fuera de temporada.
• Aves — BirdNET-Lite (audio) es fuerte en las ~6,000 especies de su modelo global cuando el canto es limpio y la especie está en rango. Las fotos de aves son más difíciles; las enrutamos por Phi-3.5-vision o Claude (clave BYO).
• Insectos, hongos, líquenes, vida marina — significativamente menos confiable. Trata cualquier ID por IA como una *sugerencia*, no una determinación.

La cascada reporta un puntaje de confianza con cada ID. Por debajo de 0.4 lo marcamos como "baja confianza" y no promovemos la observación a research-grade. Por arriba de 0.4 sigue siendo tu trabajo mirar la foto y decidir si la sugerencia coincide con lo que viste.

¿Puedo corregir una identificación?

Sí. En el formulario de observación (o después, en la página de detalle de la observación), edita el campo de nombre científico y guarda. Tu entrada manual sobreescribe la sugerencia de la IA; la sugerencia original de la IA se mantiene en el historial de identificación para transparencia.

Si eres investigador credenciado, tus ediciones a observaciones de otros llevan un peso 3× en el algoritmo de consenso — ver la sección de docs sobre validación experta para cómo aplicar.

Audio

¿Por qué BirdNET me pide descargar algo?

BirdNET-Lite es el identificador de audio on-device (Cornell Lab of Ornithology; CC BY-NC-SA 4.0). El archivo del modelo es ~50 MB. Lo descargamos una vez, la primera vez que grabes audio, y lo cacheamos localmente. Después de eso:

• La identificación corre completamente en tu teléfono.
• El audio nunca sale de tu dispositivo.
• Funciona offline.

Puedes limpiar el modelo cacheado desde Perfil → Editar → BirdNET-Lite → Limpiar caché si alguna vez necesitas re-descargarlo.

¿Por qué mi grabación no se identifica?

Causas probables:

• Modelo no descargado aún — la primera grabación descarga el modelo; las grabaciones siguientes usan la copia cacheada.
• La especie no está en el modelo global de 6,000 especies — BirdNET-Lite prioriza las especies más grabadas a nivel mundial. Endémicas y rarezas regionales pueden estar ausentes.
• Grabación demasiado corta o ruidosa — el modelo necesita al menos ~2-3 segundos de señal relativamente limpia. Mucho viento, tráfico o voces traslapadas destruyen el espectrograma.
• Taxón equivocado — BirdNET solo maneja aves. Cantos de insectos, mamíferos y ranas están fuera de alcance hoy.

Privacidad y datos

¿A dónde van mis fotos?

Depende de si iniciaste sesión y si disparaste una identificación:

• Sesión iniciada: las fotos se suben a Cloudflare R2 (media.rastrum.org) y se vinculan a la fila de tu observación en Supabase. La visibilidad por defecto es pública; puedes marcar una observación como oscurecida para especies sensibles.
• Invitado / offline: las fotos se quedan en el outbox de IndexedDB de tu teléfono hasta que estés en línea y con sesión iniciada.
• Identificación: las fotos se envían a PlantNet (cuando hay clave configurada) y a Anthropic (solo cuando provees tu propia clave). Nunca se envían a Anthropic por defecto.
• Modelos on-device (BirdNET, EfficientNet-Lite0, Phi-3.5-vision, Llama-3.2-1B) nunca ven la red para los datos — solo la descarga única del modelo en sí.

Ver la página de privacidad para el desglose completo.

¿Puedo eliminar mi cuenta?

Sí. Inicia sesión → /perfil/editar/ → Eliminar cuenta. Después de la confirmación:

• Tu identidad de auth se elimina.
• Tus observaciones se anonimizan (el vínculo a tu user id se rompe).
• Las fotos en R2 se ponen en cola para purga en 30 días.
• El audio se elimina inmediatamente.
• Las identificaciones y comentarios se conservan pero se anonimizan.

Si quieres una exportación completa primero, usa /perfil/exportar/. Si necesitas observaciones eliminadas completamente (en lugar de anonimizadas), abre un issue y lo resolvemos.

¿Y si quiero que mi observación sea privada?

Dos caminos:

• Las especies sensibles se oscurecen automáticamente. Si tu observación coincide con NOM-059-SEMARNAT-2010 o apéndices CITES, las coordenadas públicas legibles se recortan a ~10×10 km. Solo tú e investigadores credenciados ven la ubicación precisa.
• Oscurecimiento voluntario. En el formulario de observación, activa el toggle "Oscurecer coordenadas". Aplica el mismo recorte.

No tenemos un modo "observación privada" (donde la observación es invisible para todos excepto tú) en v1.0. Si tienes un caso de uso, abre un issue.

Offline y sincronización

¿Qué pasa si observo sin señal?

• La observación, fotos y audio se guardan inmediatamente en el outbox de IndexedDB.
• Aparece un indicador "pendiente de sincronizar" en el dropdown del avatar.
• Cuando la siguiente solicitud de red tenga éxito, el outbox se vacía: los medios van a R2, la fila de la observación va a Supabase, las identificaciones corren en el servidor.
• Si la sincronización falla, reintentamos en el siguiente evento online. No tienes que hacer nada.

Puedes seguir observando mientras la sincronización corre en segundo plano.

¿Qué pasa si pierdo mi teléfono?

• Las observaciones sincronizadas están seguras en tu cuenta de Rastrum. Inicia sesión en otro dispositivo y aparecen inmediatamente.
• Las observaciones de invitado sin sincronizar se pierden — solo vivieron en el IndexedDB del teléfono perdido. Esta es la única razón buena para iniciar sesión.

Si inicias sesión *antes* de perder el teléfono, todo lo que se sincronizó es durable. Si inicias sesión *después* de perderlo, los registros sin sincronizar se fueron.

Técnico

¿Dónde puedo reportar bugs?

Dos lugares:

• El botón Reportar problema al pie derecho de cada página (rellena un issue de GitHub con tu locale, página e info básica del dispositivo).
• Directo en github.com/ArtemioPadilla/rastrum/issues.

Para una pregunta más conversacional (peticiones de feature, "cómo hago…"), prefiere Discussions.

¿Puedo usar la API?

Sí. Rastrum expone una API REST en /functions/v1/api/... y un servidor Model Context Protocol en /functions/v1/mcp para agentes de IA.

• Crea un token personal en /perfil/tokens (formato: rst_*).
• Los tokens tienen scopes (observe, identify, export).
• Ver el índice de docs para el módulo 14 (REST) y el módulo 15 (MCP). Hay ejemplos para Claude Desktop, Cursor, VS Code y GitHub Copilot Coding Agent en esos specs.

¿Por qué veo la versión vieja después de un deploy?

Normalmente un service worker viejo. Haz hard-refresh ( Ctrl+Shift+R en Win/Linux, Cmd+Shift+R en Mac) o cierra y vuelve a abrir la pestaña. Si aún ves la versión vieja, ver el runbook del service worker para pasos de diagnóstico.

¿Algo más?

Abre un issue en github.com/ArtemioPadilla/rastrum/issues y te respondemos (y agregamos la respuesta aquí si es una pregunta recurrente).

Última actualización: 2026-04-25.