Skip to content

Repository files navigation

🚀 Copiloto Elite

Asistente de voz en español para Elite Dangerous. Escucha tus órdenes por voz, responde con voz neuronal natural, vigila el registro del juego en tiempo real para avisarte de lo importante, y muestra un panel visual en el navegador (también desde el móvil).

No modifica el juego: solo lee sus archivos de registro (journal, Status.json, Market.json…) y envía pulsaciones de teclas para las maniobras que le pides.


📦 Instalación desde cero

Necesitas Python 3.10+ en Windows. Desde la carpeta del proyecto:

pip install -r requirements.txt

Esto instala la voz neuronal (Edge TTS), el reconocimiento de voz, el envío de teclas y las librerías de red. Con eso ya funciona todo lo básico.

Opcional — palabra de activación y reconocimiento offline (Vosk):

  1. pip install vosk
  2. Descarga el modelo vosk-model-small-es-0.42 de https://alphacephei.com/vosk/models
  3. Descomprímelo en una carpeta llamada modelo_vosk junto a leer_ubicacion.py

Opcional — IA de a bordo: añade una clave API de Claude (o, gratis, de Groq) en el panel de configuración para habilitar el comando consulta [pregunta].

Opcional — reconocimiento Whisper (local y más preciso que Google): pip install faster-whisper y elige "Whisper local" en el panel CONFIG. La primera vez descarga el modelo (~500 MB con "small"); después funciona sin internet.


▶️ Arranque

Doble clic en IniciarCopiloto.bat (arranca minimizado y abre el panel), o bien:

python leer_ubicacion.py

El panel visual queda en http://localhost:5000. Desde el móvil en la misma WiFi, en la dirección que se imprime al arrancar (http://<tu-ip>:5000).

Por defecto se habla pulsando F4 (configurable). Si tienes la palabra de activación puesta, basta con decirla (p. ej. "ordenador").


🎙️ Comandos de voz

Navegación y sistema

Dices… Hace
"¿Dónde estamos?" Sistema y estación actuales
"Información del sistema" Facción, seguridad, economía, población
"¿Es peligroso el sistema?" Muertes y tráfico reales (EDSM)
"¿A qué distancia está [sistema]?" Años luz y saltos aproximados
"Traza ruta a [sistema]" Ruta por la autopista de neutrones; te avisa en cada salto
"Cancela ruta" Borra la ruta de neutrones activa
"¿Cuántos saltos quedan?" Progreso de la ruta trazada en el mapa

Estado de la nave y vuelo

Dices… Hace
"Estado de vuelo" / "Situación" Informe completo (detecta si vas a pie)
"Combustible" Nivel de depósito y reserva
"Estado de la nave" Módulos ingenierizados (en el panel)
"Solicitar aterrizaje" Abre el panel de contactos cerca de una estación

Comercio y mercado

Dices… Hace
"¿Dónde compro [mercancía]?" Estación más cercana que la vende (Spansh)
"¿Dónde compro [módulo] clase 5 A?" Astillero más cercano con ese módulo (FSD, planta de energía, escudo…)
"¿Dónde vendo [mercancía]?" Estación más cercana que la compra (Spansh)
"¿Dónde vendo la carga?" Analiza la bodega y busca UNA estación que compre todo el cargamento
"Busca ruta comercial" Bucle de compra/venta rentable desde tu estación (hay que estar acoplado)
"Precio de [mercancía] aquí" Precio real del mercado local (acoplado)
"Informe de minería" Toneladas refinadas, ritmo por hora y valor estimado de la sesión
"Busca comerciante de [crudos/fabricados/codificados]" Comerciante de materiales cercano

Ingeniería y materiales

Dices… Hace
"¿Qué me falta para [plano] grado N?" Materiales que faltan según tu inventario
"Ruta para [ingeniero]" Cómo desbloquear un ingeniero (nave u Odyssey)
"Informe de ingenieros" / "…de Odyssey" Lista en el panel
"Listar materiales" / "Inventario" Tu inventario de materiales
"Buscar [material]" Grado y categoría de un material
"¿Cómo farmeo [datos/compuestos/materias primas/armas o módulos Guardián]?" Tus rutas personales de farmeo

Exploración y a pie (Odyssey)

Dices… Hace
"¿Dónde está mi nave?" Distancia y rumbo hasta la nave (a pie)

Misiones, dinero y carrera

Dices… Hace
"¿Qué misiones tengo?" Misiones activas y recompensa total
"Progreso de masacre" Bajas por facción en misiones de masacre apiladas
"¿Cuánto llevo sin cobrar?" Vales de caza/combate pendientes
"¿Cuántas multas tengo?" / "¿Dónde pago las multas?" Deuda y Factores Interestelares cercanos
"Analizar progresión" Fase de tu carrera y consejo
"Mis estadísticas de carrera" Patrimonio, distancia, sistemas… (de toda tu vida)
"¿Cómo fue la semana?" Resumen del diario (7 días; di "el mes" para 30)

Utilidades

Dices… Hace
"Consulta [pregunta]" Pregunta libre a la IA de a bordo (recuerda la conversación)
"Anota objetivo" / "Borrar objetivo" Guarda un recordatorio de objetivo
"Recuérdame en [N] minutos [texto]" Temporizador por voz
"Comandos" / "Ayuda" Muestra la lista en el panel
"Apagar" Resumen de sesión, guarda el diario, hace copia de seguridad y cierra

Maniobras (envían la tecla del juego)

Se leen automáticamente de tus controles (.binds). Por defecto: "Tren de aterrizaje", "Luces", "Bodega", "Armas", "Silencio", "Flight assist", "Mapa galáctico", "Mapa de sistema", "Panel de rol", "Cámara externa", "Disipador", "Chaff".

Consejo: si el copiloto habla de más, pulsa la tecla de hablar para cortarle. Al cortarle también descarta lo que tuviera pendiente de decir en ese instante.


🔔 Avisos automáticos (sin pedirlos)

Navegación: llegada a cada sistema con su información, escaneo automático de descubrimiento (honk) al llegar, número de cuerpos, aviso al saltar a estrella no repostable con poco combustible, depósito lleno al repostar.

Estación: plataforma de aterrizaje asignada, atraque concedido/denegado, recordatorio de vales y multas pendientes al acoplar.

Combate: casco dañado, escudos caídos/restablecidos, interdicción (distinguiendo jugador real de NPC), aviso de escaneo de carga (posible pirata), delitos y multas al momento.

Minería: contenido de cada asteroide prospectado (o pitidos, si lo activas), bodega llena.

Exploración: cuerpos valiosos al escanear, señales biológicas al mapear.

Exobiología (a pie): especie y valor al muestrear, radar de distancia entre muestras (avisa cuando te has alejado lo suficiente), primer registro en el códice.

A pie (Odyssey): oxígeno bajo, salud crítica, temperatura extrema.

Farmeo: material al máximo del inventario, Emisiones de Alta Calidad detectadas.

Misiones: aviso cuando una está a punto de caducar (menos de 1 hora), y aviso al completar cada misión de masacre apilada (las bajas cuentan para todas las facciones a la vez).


⚙️ Configuración (panel → CONFIG)

  • Tecla para hablar (PTT) — por defecto F4.
  • Voz y velocidad — varias voces neuronales en español.
  • Escaneo automático — el honk al llegar a un sistema (sí/no) y en qué disparador tienes el escáner (primario/secundario, teclado o ratón).
  • Palabra de activación — hablar sin pulsar tecla (requiere modelo_vosk).
  • Motor de reconocimiento — Google (online, por defecto) o Whisper local (más preciso; requiere pip install faster-whisper).
  • Minería con pitidos — pitidos en vez de voz por cada asteroide.
  • Claves API — de Claude (mejor) o de Groq (gratis) para el comando consulta.

🗂️ Archivos

Se versionan (código y datos generados):

  • leer_ubicacion.py — el programa.
  • panel.html — el panel visual.
  • config.json — teclas de maniobras.
  • materiales_datos.json, ingenieros_datos.json, ingenieros_odyssey_datos.json, planos_datos.json — bases de datos (generadas desde EDCD/FDevIDs).

Personales (excluidos de git, se respaldan a backups/ al apagar):

  • ajustes.json — tus preferencias y claves API.
  • diario.json — tu bitácora (hallazgos y sesiones).
  • materiales_aprendidos.json — nombres de materiales aprendidos de tu journal.
  • memoria.json — tu objetivo guardado.

📚 Fuentes de datos

Sistemas y coordenadas verificados vía EDSM. Estaciones, mercados y rutas de neutrones vía Spansh. Materiales, ingenieros y recetas de planos desde los datos comunitarios de EDCD (FDevIDs y coriolis-data). Cuando una fuente no es fiable, el copiloto lo dice en vez de inventar el dato.

Ninguna de estas APIs requiere clave. Solo la IA de a bordo (opcional) necesita una clave de Claude o Groq.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages