bilawalsidhu/gods-eye-viewUn simulador de satélite espía en tu navegador, excepto que los datos son reales. Inteligencia espacial de código abierto en vivo sobre un globo terráqueo 3D fotorrealista.
Globo terráqueo 3D fotorrealista. Aeronaves, barcos, satélites, terremotos, tráfico y cámaras públicas en vivo, con vistas modeladas claramente etiquetadas cuando no hay una transmisión en vivo disponible. Control por voz manos libres impulsado por un agente de IA en tiempo real.
Ningún lugar queda atrás.
▶️ Del proyecto detrás de la serie viral Vista de Ojo de Dios (anteriormente WorldView) — 5M+ en YouTube
Inicio rápido · Los primeros cinco minutos · Háblale · · · ·
Lo pediste, así que está sucediendo. Vista de Ojo de Dios es código abierto. Rastrea el mundo en vivo. Háblale. Rómpelo. Extiéndelo.
La mayor parte de la inteligencia de código abierto es un montón de pestañas del navegador. Las señales son abundantes, pero la interfaz es el cuello de botella. Vista de Ojo de Dios convierte esas señales en un lugar: el mundo ya está transmitiendo — transpondedores de vuelo, balizas de barcos, elementos orbitales, sismógrafos, cámaras públicas — y esto lo hace visible en una Tierra 3D fotorrealista en tiempo real. No se requiere autorización clasificada; es señal pública de principio a fin, y la interfaz se ejecuta en tu navegador, bajo tu control.
La mitad de la magia es que parece una cabina prohibida. La otra mitad es que cada línea de código es inspeccionable.
Las capas en vivo se basan en fuentes públicas: el avión de pasajeros que cruza tu pantalla está reportando telemetría, la cámara está instalada en una ubicación publicada, y la posición de la ISS se propaga a partir de elementos orbitales actuales. El cliente deliberadamente renderiza los vuelos un intervalo de sondeo por detrás del tiempo real para poder interpolar suavemente. Algunas experiencias están modeladas en lugar de ser en vivo: el tráfico sin claves está etiquetado como simulación, las poses de las cámaras se estiman hasta que se calibran, y la reproducción del ascenso de lanzamiento está marcada como RECONSTRUCTED ESTIMATE. Cada capa mantiene visible su fuente y estado de frescura, incluidos los estados parcial, retrasado, simulado y no disponible.
Requiere Node.js 24.14.x o 26.x (aplicado por package.json).
.env.example → .env y establece GOOGLE_MAPS_API_KEY.3. Abre **`http://localhost:4173`**. El arranque en frío se estabiliza en menos de dos segundos en un portátil reciente (mediana de 1,86 s en una captura puntual M5/Chrome — [docs/PERFORMANCE.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/PERFORMANCE.md); una línea base de comparación, no un requisito de hardware). Una tarjeta de primer uso ofrece preparar una misión para ti — **Live Contacts**, **Space Missions**, **Environmental** — o te deja explorar manualmente.
> [!TIP]
> **¿No eres programador? Haz que una IA haga toda esta página por ti.** Hay un instalador de un clic en preparación — hasta entonces, instala un agente de codificación ([Claude Code](https://claude.com/claude-code), [Codex](https://openai.com/codex/), [Cursor](https://cursor.com) o [Antigravity](https://antigravity.google)) y pega esto:
>
> ```text
> Clone https://github.com/bilawalsidhu/gods-eye-view and set it up on my machine.
> Install everything it needs, walk me through getting the required Google Maps API
> key step by step (plus any optional free keys I want), put the keys in .env, and
> help me set a billing alert and a usage quota on the Google key so I can't
> overspend. Then start the dev server and open it in my browser. I'm not a
> developer — explain what you're doing as you go, and ask me before any step
> that could cost money.
> ```
**Esa única clave es todo el precio de entrada.** Todo en este README está codificado por colores — 🟢 no necesita nada · 🟡 clave gratuita · 🔴 medido — y Google Maps es el único 🔴 que necesitas: te compra el planeta fotorrealista, y la mayor parte del globo se ilumina en 🟢 a partir de ahí. Para una exploración típica en solitario, espera **$0 en la mayoría de las capas** y calderilla en las dos medidas: Google actualmente ofrece **1.000 sesiones gratuitas de teselas 3D al mes** — cada una válida para hasta tres horas de renderizado, algo muy difícil de agotar para una sola persona — y la voz lleva un límite integrado de sesión de $5. Mapa completo en [Keys & Costs](#-api-keys), desglose honesto completo en [What it actually costs](#-what-it-actually-costs).
El servidor de desarrollo se vincula a **localhost** — tus claves permanecen en tu máquina. Compartir en una LAN de forma segura se cubre en [Sharing an instance](#-sharing-an-instance) y [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md).
**Atajo para macOS:** `./scripts/dev-fresh.sh` limpia la caché de Vite y extrae tus claves directamente del Llavero.
---
## 🕐 Los Primeros Cinco Minutos
Sin cuenta, sin registro. La tarjeta de primer uso te ofrecerá preparar una misión — o pasa tú mismo por esta prueba. En algún momento de estos cinco minutos deja de sentirse como una demo:
1. **Ilumina el cielo.** Toma la misión **Live Contacts** (o activa **Flights** tú mismo) — miles de aeronaves en vivo, deslizándose con telemetría real, con la malla de detección ya leyendo la escena. Haz clic en una: la cámara se fija, se dibuja una estela detrás y aparece su tarjeta de telemetría en vivo.
2. **Toma los controles.** Pulsa **COCKPIT** en tu avión rastreado y acompáñalo en el descenso, cambiando de sensor en pleno vuelo: NVG a Ironbow FLIR. La cabina lleva su propia franja informativa — señales en vivo cercanas, titulares regionales y clima local real, con un modo **WX** opcional que renderiza nubes volumétricas a partir de observaciones reales alrededor de tu aeronave — y **Contacts** mantiene el registro de 250 km a un clic (o una frase) de distancia: salta de avión en avión y cae directo a la siguiente cabina.
3. **Aterriza en un aeropuerto concurrido.** Busca uno y desciende hasta las calles de rodaje con los aviones **3D** activados — contactos en tierra, estelas de rodaje, todo el apron trabajando en tiempo real.
4. **Mira a través de una cámara pública.** Activa **CCTV** sobre Austin, Londres o California. Las transmisiones no son incrustaciones de webcam — se proyectan *dentro* de la ciudad 3D. Cambia la cobertura a **VIEWSHED** y cada cámara dibuja su volumen de cobertura estimado — hasta dónde llega y dónde se queda ciega.
5. **Pinta las calles con la hora punta.** Activa **Traffic** y sumérgete por debajo de ~8 km — el flujo por vehículo se colorea según los atascos reales (con una clave de TomTom; sin clave es una simulación etiquetada). Luego pulsa **NEAREST** en el panel de CCTV y observa el atasco a través de la cámara apuntando hacia él.
6. **Rastrea algo en órbita.** Activa **Satellites** y haz clic en la ISS — viajas junto a ella a distancia orbital, con anillo orbital y todo.
7. **Cambia la óptica.** Pulsa `1`–`7` — CRT, NVG, FLIR — y todo el planeta en vivo se re-renderiza a través de un sensor diferente.
8. **Háblale** *(necesita una clave de OpenAI)*: *"Llévame a LAX y selecciona la aeronave en vuelo más cercana."*
9. **Vuelve a casa.** Pulsa **Reset Globe** — o simplemente di *"aleja hasta una vista de globo."*
**Teclado:** `1`–`7` estilos visuales · `H` HUD · `D` detección · `C` cabina · `Esc` para salir.
---
## 🎙️ Háblale
> La voz necesita una **clave de OpenAI**. Sin una, toda la aplicación sigue funcionando — el botón de micrófono solo informa que la voz no está disponible. La misma clave impulsa el **resumen de IA del HUD**: una lectura concisa de cinco palabras, estilo inteligencia, de la vista actual que se regenera mientras te mueves.
Haz clic en **GEV MIC**, concede el micrófono y simplemente habla. Esto es más que un control remoto por voz:
- **🧠 Sabe lo que está mirando.** El agente extrae el contexto de la escena en vivo antes de responder — incluyendo coordenadas, nombres de calles, capas activas y escala de vista. Pregunta *"¿qué ciudad es esta?"* en pleno vuelo y lo sabe.
- **🎯 Preguntas sobre entidades.** Haz clic en cualquier avión, barco o centro de datos y pregunta *"¿qué es esto?"* Responde usando la telemetría en vivo del objeto.
- **👁️ Anclaje visual.** A nivel de calle, lee una captura de pantalla del viewport para identificar señalización legible y nombres de edificios, y está instruido para nunca alucinar etiquetas.
- **🎬 Encuadre cinematográfico.** *"Muéstrame los aviones en el cielo"* aleja la cámara, la inclina y encuadra el tráfico en vivo como un director.
- **🔒 Honesto y seguro.** El agente solo confirma acciones que tuvieron éxito. Tu `OPENAI_API_KEY` nunca toca el navegador; el cliente solo recibe un token de sesión de corta duración.
Veintiocho herramientas, cuatro trabajos — los comandos siguientes provienen directamente de la suite de pruebas de voz y el manual de herramientas del producto:
**🎥 Dirígelo** — verbos de cámara estilo operador de dron:
> 🗣️ *"Llévame a Tokio."* · *"Orbita alrededor de esta zona lentamente."* · *"Dibuja la ruta a pie desde el Capitolio hasta Zilker Park."* → *"Vuela la ruta que acabamos de dibujar."* · *"Aleja hasta una vista de globo."*
**🖊️ Anótalo** — una pizarra sobre el mundo real:
> 🗣️ *"Delimita el estado de Texas."* · *"Anota el Capitolio del Estado de Texas y sus terrenos"* — dibuja el **límite envolvente real**, no un círculo. · *"¿A qué distancia está la Torre Eiffel del Louvre?"* — aparece una flecha conectora y dice la distancia en voz alta. Todo persiste hasta que digas *"limpia el mapa."*
**🔎 Interróguelo** — consultas de analista contra las capas en vivo:
> 🗣️ *"¿Cuántos vuelos hay sobre Texas ahora mismo?"* · *"¿Qué barcos se dirigen a Oakland?"* · *"¿Cuál es el incendio más grande cerca de Los Ángeles?"* · *"¿Hay algo volando por encima de cuarenta mil pies?"* · *"¿Cuándo pasa la ISS la próxima vez?"*
**🎛️ Opéralo** — toda la consola, sin usar las manos:
> 🗣️ *"Cambia a visión nocturna y activa la capa de vuelos."* · *"Activa los viewsheds de las cámaras."* · *"Reproduce una emisora de noticias cerca de Austin."* · *"Rastrea ese avión."* → *"Entra en la Cabina."*
**Y el nivel de fuego rápido** — una frase cada uno:
> 🗣️ *"Muéstrame la infraestructura global."* (prepara las capas y aleja hasta el globo) · *"Reproduce Orbital Watch."* (una escena cinematográfica completa) · *"Establece la densidad de detección al cincuenta por ciento."* · *"Siguiente contacto — solo helicópteros."* (en plena cabina) · *"Muéstrame las misiones espaciales."* · *"Cambia a Bing aerial."* · *"Afinar un poco la imagen."* · *"Cambia al diseño táctico."* · *"¿Qué está activado ahora mismo?"*
*Pide radio cerca de cualquier lugar y el globo empieza a emitir — cada emisora es un lugar real al que puedes volar.*
---
## 🛰️ Qué Hay en el Globo
Trece capas en vivo. **Diez de ellas no necesitan nada en absoluto** — sin clave, sin cuenta, sin registro.
| Capa | Qué obtienes | Fuente | Auth |
|-------|--------------|--------|------|
| 🗺️ **Map Stack** | Google Photorealistic 3D, Bing aerial, OSM | Google / Ion / OSM | 🔴 Google (requerida) · 🟡 ion para Bing · 🟢 OSM |
| ✈️ **Live Flights** | Miles de aeronaves en vivo + historial de rutas | OpenSky + adsb.lol | 🟢 (🟡 opcional para más créditos de polling) |
| 🎖️ **Military Flights** | Tráfico militar ADS-B en ámbar | adsb.lol | 🟢 |
| 🚢 **Live Vessels** | Miles de barcos en todo el mundo | AISStream | 🟡 |
| 🛰️ **Satellites** | Un catálogo central de aproximadamente 840 objetos, codificado por colores según su clase con una leyenda en vivo — el chip **DENSE** incorpora toda la constelación Starlink | CelesTrak | 🟢 |
| 🌍 **Earthquakes** | Actividad sísmica global, últimas 24 h | USGS | 🟢 |
| 🚗 **Traffic** | Congestión en vivo que impulsa el flujo por vehículo a nivel de calle — sumérgete por debajo de ~8 km y los puntos se colorean según los atascos reales. Sin clave es una simulación aproximada | TomTom + OSM | 🟢 (🟡 TomTom lo hace real — consigue una) |
| 📹 **CCTV Mesh** | ~800 cámaras públicas proyectadas *dentro* del espacio 3D — Austin · California (Caltrans) · Londres (TfL). Las posiciones están publicadas; las poses son prioris estimados **que tú calibras arrastrando un gizmo sobre la propia cámara** | City APIs | 🟢 |
| 📻 **Radio** | Radio mundial geolocalizada con un **sintonizador analógico** — arrastra la aguja entre hasta 750 emisoras y el globo vuela hasta cada emisora | Radio Browser / broadcasters | 🟢 |
| 🚲 **Bikeshare** | Disponibilidad de estaciones en vivo | GBFS | 🟢 |
| 🔥 **Active Fires** | Detecciones en vivo de NASA FIRMS, últimas 24 h | NASA FIRMS | 🟡 |
| 🚀 **Space Missions** | Lanzamientos móviles de 30 días con detalle de carga útil, etapa y recuperación | Launch Library 2 | 🟢 (🟡 token opcional aumenta el límite) |
| 🎖️ **Mapped Installations** | Contexto de sitios militares limitado al viewport desde mapeo comunitario — incompleto por naturaleza, y etiquetado así | OpenStreetMap | 🟢 |
**También en el globo:** superposiciones de vecindarios · un efecto de nubes WX opcional en la cabina. **Infraestructura estática incluida:** Centros de datos (4.351), Presas (704) y Cables Submarinos (712).
**¿Te falta una capa que quieras?** Abre un issue — o añádela y envía el PR.
---
## 🎖️ Misiones de Campo
Una vez que lo básico encaja, ejecuta estas:
| Misión | Cómo |
|---|---|
| **🚁 Pregúntale al planeta** | *"¿Por qué todos estos helicópteros militares vuelan en círculos?"* Selecciona un track militar — rellena silenciosamente ~24 h de historial de rastro real — y observa qué ha estado haciendo, resuelto como bucles 3D apilados. |
| **✈️ Aproximación final** | Haz clic y rastrea un avión de línea alineándose para una pista, salta a la **cabina** y acompáñalo en el descenso. |
| **🌃 Vigilia nocturna** | Vuela a tu propia ciudad, cambia a **NVG** y deja que la malla de detección y el HUD lean la escena. |
| **🚢 Llamada de puerto** | Barcos sobre el Puerto de Long Beach. Haz clic en un petrolero para ver su tarjeta táctica y su estela — luego pulsa **NEAREST** en el panel de CCTV y mira la misma agua a través de una cámara pública. |
| **📻 Tokyo FM** | Orbita Shibuya con la capa **Radio** activada — luego arrastra la aguja del sintonizador analógico: cada posición se fija a una emisora real y el globo vuela hasta quien esté emitiendo. |
| **🔥 Línea de fuego** | FIRMS sobre California. Haz clic en una detección — la cámara se sumerge hasta ella — lee la intensidad y luego pulsa **NEAREST** en el panel de CCTV para una vista desde tierra. |
| **🚶 Pide una ruta a pie** *🎙️* | Dile al mundo a dónde quieres ir y observa una ruta real que sigue las calles trazarse a través de la ciudad 3D — luego *"vuela"*: giros peraltados, finales suavizados, una cámara que lidera el camino como una toma de dron. |
| **📏 Mide LAX a DFW** *🎙️* | *"¿A qué distancia está LAX de DFW?"* — una flecha cruza el país, la distancia aterriza en el pie de foto y los extremos permanecen fijados al mundo real mientras orbitas. |
| **🚀 Repetición de lanzamiento** | Abre **Space Missions**, elige un lanzamiento de los últimos 30 días y acompaña la cuenta atrás T-minus a través del ascenso hasta la órbita — recórrela a 0,25×–4×. Etiquetado `RECONSTRUCTED ESTIMATE`, porque lo es. |
| **🪦 Camina por el cementerio** | Vuela desde el contexto regional hasta densas filas completamente resueltas de aeronaves retiradas. |
| **🏗️ Orbita las Tres Gargantas** | Recorre la presa y su terreno de un vistazo — luego activa la capa **Dams** y encuentra 703 más. |
| **🌊 Traza la columna vertebral** | Sumérgete hasta las Bahamas con **Submarine Cables** activado — rutas etiquetadas se revelan bajo el agua, 712 en todo el mundo. |
*🎙️ = misiones por voz — necesitan una clave de OpenAI.*
*Pregúntale al planeta: las últimas ~24 horas de historial de rastro real de un contacto militar, resueltas como bucles 3D apilados.*
*"Dibuja la ruta a pie… ahora vuela" — giros peraltados, finales suavizados, la cámara liderando el camino como una toma de dron.*
*Camina por el cementerio: filas de fuselajes retirados, completamente resueltos en 3D.*
*Repetición de lanzamiento: un ascenso de Falcon 9, etiquetado `RECONSTRUCTED ESTIMATE`, recorrible a 0,25×–4×.*
*Traza la columna vertebral: las rutas de cables submarinos bajo las Bahamas.*
---
## 🔧 Bajo el Capó
Parte de la ingeniería que lo hace sentir real en lugar de una demo tecnológica:
- **Iconos estables en el mundo.** Las aeronaves y los barcos apuntan a lo largo de su *rumbo real verdadero* en cada ángulo de cámara — rastreados o no, mirando directamente hacia abajo o a través del horizonte — mediante proyección de rumbo en espacio de pantalla por fotograma. Sin giros, sin bloqueo al viewport.
- **Movimiento suave a partir de datos entrecortados.** Las transmisiones en vivo llegan cada 15–30 s; el globo renderiza un intervalo por detrás del tiempo real e interpola entre fijaciones conocidas. La navegación a estima llena los vacíos.
- **Satélites honestos.** Propagación SGP4 con anillos orbitales que permanecen fijados a sus satélites mediante realineación GMST — sin deriva, sin parpadeo por segundo.
- **Se asienta sobre el suelo real.** Las alturas de las entidades pasan por un datum vertical real — consciente del geoide, muestreado contra la *malla de terreno renderizada* — para que las aeronaves se estacionen en los aprons y las cámaras se sitúen en las esquinas de las calles en lugar de flotar.
- **Gasta tu cuota como si fuera suya.** Las transmisiones de pago se ejecutan detrás de proxies en caché con presupuesto gobernado — un gobernador de créditos de OpenSky, un presupuesto diario de teselas de TomTom, TLEs en caché en disco — para que una tarde de exploración no queme una asignación de API.
- **Manejo de claves local primero.** Los proveedores con secretos como OpenAI, AISStream, OAuth de OpenSky, TomTom y FIRMS se gestionan del lado del servidor. Los destinos de proxy son fijos o están en lista blanca, y las rutas de mayor riesgo añaden solicitudes limitadas, tiempos de espera, límites de respuesta y errores saneados según corresponda. Las únicas credenciales de proveedor expuestas intencionalmente al navegador son Google Maps y Cesium ion; restringe ambas en el proveedor.
- **Sin framework.** JavaScript vainilla, **CesiumJS** y **Vite** — además de **Google Photorealistic 3D Tiles** para el planeta y la **OpenAI Realtime API** para la voz. Rápido de leer, rápido de hackear.```
src/
├── main.js # Bootstrap: Google 3D tiles, layer registration
├── ui.js # Runtime UI — panels, HUD, styles, control facade
├── hud.js # Intelligence HUD + AI scene summary
├── mapStackController.js # Google 3D / Bing / OSM switching
├── iconOrientation.js # Screen-projected world-space headings + horizon cull
├── voice/ # OpenAI Realtime session + 28 voice tools
├── data/ # One module per layer + management + context store
│ └── local_data/ # Bundled datasets (per-folder provenance)
└── scenes/ # Cinematic scene director
See docs/CURRENT-STATE.md para la referencia de ejecución autoritativa.
La leyenda, una vez más: 🟢 sin registro — funciona de serie · 🟡 clave gratuita — regístrate, pega, listo · 🔴 medido — una cuenta con facturación habilitada; los costes son pequeños pero reales.
La mayor parte del mundo es 🟢: vuelos (anónimos), tráfico militar, satélites, terremotos, CCTV, radio, bicicletas compartidas, misiones espaciales, instalaciones mapeadas y todos los conjuntos de datos incluidos funcionan con cero claves.
Cinco claves cubren la experiencia totalmente equipada. Tres ofrecen actualmente acceso de desarrollador sin coste; Google Maps y OpenAI se miden por uso. Los precios y las asignaciones de los proveedores cambian, así que consulta las páginas de precios enlazadas antes de confiar en una estimación de presupuesto:
| Clave | Por qué | Consíguela | |
|---|---|---|---|
| 🔴 | Google Maps (obligatoria) | El planeta 3D fotorrealista (Map Tiles API) | Google Cloud Console — medido; consulta los precios actuales y restringe por URL |
| 🔴 | OpenAI | 🎙️ La experiencia de voz + resumen del HUD con IA. ¿Quieres otro proveedor detrás del micrófono? Las PRs son bienvenidas | platform.openai.com — medido; consulta los precios actuales de la API |
| 🟡 | AISStream | 🚢 Barcos globales en vivo | aisstream.io — gratuito, en serio, es un registro de dos minutos |
| 🟡 | NASA FIRMS | 🔥 Incendios activos en vivo | firms.modaps.eosdis.nasa.gov — gratuito |
| 🟡 | TomTom | 🚦 Tráfico real en lugar de una simulación aproximada | developer.tomtom.com — consulta la asignación de desarrollador actual para tu cuenta |
Lo que te aporta la clave de TomTom: el paso 5 de Los Primeros Cinco Minutos de verdad — densidad real de hora punta pintada sobre la ciudad en lugar de una simulación aproximada.
| Clave | Por qué | Consíguela | |
|---|---|---|---|
| 🟡 | Cesium ion | 🗺️ Pilas de mapas de imágenes de Bing (token público assets:read) | cesium.com/ion — consulta el plan que se ajusta a tu uso |
| 🟡 | OpenSky | ✈️ Más créditos de consulta de vuelos (🟢 el anónimo funciona sin ellos) | opensky-network.org |
| 🟡 | Launch Library 2 | 🚀 Mayor asignación de solicitudes de misiones espaciales (🟢 funciona sin ella) | thespacedevs.com |
Todas merecen la pena. Ninguna es necesaria para empezar.```bash
OPENAI_API_KEY="…" AISSTREAM_API_KEY="…" npm run dev -- --host localhost --port 4173
En macOS también puedes guardar cualquier clave en el Llavero (Keychain) y `./scripts/dev-fresh.sh` las recoge — los nombres de servicio de `security add-generic-password` están documentados en `.env.example`.
OpenSky puede ejecutarse completamente anónimo (`OPENSKY_AUTH_MODE=anon`), o importar credenciales OAuth con `./scripts/opensky-import-client.sh /path/to/credentials.json`.
### 💸 Lo que realmente cuesta
Números honestos, aproximadamente, a mediados de 2026 — consulta siempre las páginas de precios del proveedor:
| | Realidad de costes |
|---|---|
| **🟢 La mayoría de capas** | **$0, sin registro.** OpenSky anon, USGS, CelesTrak, adsb.lol, CCTV urbano, Radio Browser, GBFS, Launch Library 2, conjuntos de datos incluidos. |
| **🟡 Acceso opcional para desarrolladores** | AISStream, FIRMS, TomTom, Cesium ion y OpenSky autenticado pueden ofrecer acceso sin coste, pero los límites y usos permitidos difieren. Cesium ion y OpenSky en particular tienen restricciones de plan o uso; verifica los términos actuales del proveedor para tu despliegue. |
| **🔴 Teselas 3D de Google** | Más generoso de lo que imaginas: la facturación cuenta **las solicitudes de tileset raíz** — una compra da hasta **tres horas** de renderizado ilimitado de teselas — y las primeras **1.000 al mes son gratis**, luego unos **$6 por cada 1.000** (precios en EE. UU.; [consulta la página actual](https://developers.google.com/maps/billing-and-pricing/pricing), las tarifas varían según la región de facturación). Un usuario individual rara vez sale del nivel gratuito. Aun así: restringe la clave, establece cuotas y configura una alerta de presupuesto antes de un uso prolongado. |
| **🔴 Voz de OpenAI** | El audio en tiempo real se mide por uso y el total depende del modelo seleccionado, la duración de la conversación y el volumen de audio. La aplicación muestra una estimación de sesión en vivo, avisa a los $2 y aplica un **límite de sesión de $5 dentro de la app**; los límites de uso del proveedor siguen siendo el respaldo de facturación. |
### 🧗 El suelo es bajo a propósito
Todo lo anterior es la base deliberadamente económica — suficiente para probar de verdad la inteligencia geoespacial, GEOINT y OSINT sin hablar jamás con un equipo comercial. También notarás el techo: el AIS terrestre se silencia en medio del océano y el AIS satelital cuesta dinero real; las imágenes premium, el SAR y los feeds comerciales más profundos viven detrás de contratos empresariales. Eso no es un límite de la arquitectura — cada capa aquí es un patrón que puedes apuntar a tus propias fuentes de datos. Este repositorio te entrega la base; lo que fusiones en ella depende de ti.
### 🔒 Compartir una instancia
Por defecto nadie más puede alcanzar tu servidor — está vinculado a localhost. Para compartir en tu LAN, actívalo explícitamente (`npm run dev -- --host 0.0.0.0 --port 4173`, o `HOST=0.0.0.0 ./scripts/dev-fresh.sh` en macOS/Linux) — pero ten en cuenta que ⚠️ **un servidor visible en la LAN entrega tus claves API configuradas a cualquiera que pueda alcanzarlo.** Establece los límites por IP (`GEV_RATELIMIT_OPENAI_PER_MIN`, `GEV_RATELIMIT_GOOGLE_PER_MIN` — ver `.env.example`) y, antes que nada, **establece límites de presupuesto del lado del proveedor** (presupuestos de Google Cloud, límites de uso de OpenAI): los límites son protecciones a nivel de aplicación, no topes de facturación. Modelo de amenazas completo en [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md).
---
## 📋 Responsable y abierto
God's Eye View funciona con **datos públicos, fuentes claras y ejecución local primero.** Sin secretos, sin conjuntos de datos privados, sin scraping misterioso — cualquier cosa que implique una clave privada se gestiona del lado del servidor. Tiene la gramática visual de una sala de operaciones clasificada, construida enteramente con señales abiertas y código inspeccionable.
**La línea.** Este proyecto modela **eventos, activos, infraestructura y sistemas** — aeronaves, embarcaciones, satélites, incendios, cámaras, ciudades. No incluye funciones de búsqueda de personas nombradas, reconocimiento facial ni seguimiento de individuos, y las solicitudes de extracción que crucen esa línea no se fusionarán. Las personas no son un tipo de consulta aquí.
**Ven a construirlo.** Este es el cliente 3D en vivo canónico del proyecto que impulsó la reciente ola de herramientas de inteligencia espacial — y es un lienzo: las capas aquí son las señales que una persona podría encontrar y fusionar. Añade un paquete de ciudad, una fuente de datos, un estilo, una herramienta de voz. Es la ventana a través de la cual ves el mundo; lleva esa ventana a otros.
**Estado:** Un cliente de código abierto en evolución para exploración y aprendizaje — una base rápida y hackeable, no un servicio de producción endurecido. Publicado bajo la **[Licencia MIT](https://github.com/bilawalsidhu/gods-eye-view/blob/main/LICENSE)**. Los conjuntos de datos incluidos y en vivo tienen sus propios términos — ver **[DATA_SOURCES.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md)**. Modelo de seguridad: **[SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md)**. ¿Quieres contribuir? **[CONTRIBUTING.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/CONTRIBUTING.md)**.
<sub>Nota de medios: Bilawal Sidhu creó y posee los 17 GIFs de captura de esta página. También publicó los dos PNG del README en el proyecto público existente y autorizó su inclusión continua aquí. Cualquier aparición de Bilawal se incluye con su permiso. Estos archivos son documentación del proyecto, no activos independientes bajo licencia MIT. Las interfaces de plataforma, marcas comerciales, avatares, datos e imágenes de terceros visibles en ellos siguen sujetos a los términos de sus respectivos propietarios. Ver [procedencia de medios](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/media/README.md) y [términos de fuentes](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md).</sub>
> [!IMPORTANT]
> God's Eye View es una visualización exploratoria de datos públicos y de terceros.
> Los datos pueden estar retrasados, incompletos, modelados, inferidos o ser incorrectos. No lo uses
> para navegación aérea o marítima, respuesta de emergencia, decisiones médicas o de salud,
> decisiones de inversión u otros fines críticos para la seguridad u operativos.
> Verifica la información importante con fuentes autorizadas.
---
## 🧭 Lo que viene después
Primero — gracias. A todos los que visteis las demos de God-view y os fuisteis a construir las vuestras, y a todos los que seguisteis pidiendo el código: estoy agradecido. Y cuando pregunté si esto debería ser de código abierto, no fuisteis sutiles al respecto:
<img src="https://assets.kitploit.com/production/public/readmes/53672/d1eee944eaf04d9063d0251d21e1c8eb3b30471dc576044bab58917e35995924/aab0b9bd11b208c5db0f4e7b6c717c6c688fe22ca0c7996169f17b4a5c526b24-display-v1.webp" alt="Encuesta comunitaria sobre abrir God's Eye View" width="460">
Así que aquí está. Entrad en la cabina del thriller de espías — excepto que los datos son reales — y convirtamos esto en nuestro arenero compartido para dar sentido al mundo, y divirtámonos haciéndolo. Este repositorio es la base, permanece abierto, y todo el punto es que rompáis cosas y añadáis capas que aún no hemos imaginado.
Un aviso desde dentro: construye en este espacio durante una semana y aprenderás que **el presente es la parte barata**. En el momento en que intentas retroceder en el tiempo — teselar, servir y revisar *lo que ocurrió* y *lo que cambió* a cualquier resolución real — los datos se vuelven caros y el cómputo se vuelve brutal. Para eso, estamos construyendo algo genial. Más en el futuro — [halfpixel.ai](https://halfpixel.ai).
---
<div align="center">
▶️ [Mira la serie God's Eye View](https://youtube.com/playlist?list=PL6qSg2I-7_koPbDnSMo0QeeHX_RknA2uv&si=nBGYMoHWQw41v93Q) · 📬 [Map the World](https://maptheworld.ai/) — el boletín detrás del proyecto
**🌐 God's Eye View. Ningún lugar queda atrás.**
</div>