● Alpha pública — protocolo FHS P2P (DEC-P2P-001)

Inteligencia artificial federada y soberana

galaxIA conecta el hardware que tu comunidad ya tiene — una Mac mini con un LLM local, una laptop con OCR, una Raspberry Pi con otra herramienta — en una sola red P2P descentralizada. Sin nube, sin suscripciones, sin un servidor central que decida qué pasa con tus datos.

10reglas del protocolo FHS
2tipos de provider: star / satellite
0servidores centrales obligatorios
MITlicencia abierta

Por qué existe galaxIA

La mayoría de asistentes de IA hoy dependen de mandar tus datos a la nube de un proveedor, pagar una suscripción, y confiar ciegamente en que ese proveedor respeta lo que promete. Eso concentra el poder de la IA en unas pocas empresas y deja a cada comunidad — un equipo, un vecindario, un grupo de investigación, una escuela — sin control real sobre su propia infraestructura de inteligencia.

El objetivo de galaxIA es demostrar que existe otro camino: una red donde cualquiera con una computadora capaz de correr un modelo o una herramienta puede sumarla, donde el chat descubre qué hay disponible sin depender de una máquina específica, donde cada nodo puede irse o fallar sin tumbar el resto, y donde la privacidad — quién ve qué, qué se retiene, a dónde viajan los datos — es parte del protocolo desde el diseño, no un aviso legal que se agrega después.

Visión, objetivo y destino

Visión

Una galaxia de IA soberana: cualquier comunidad — una escuela, un equipo, un grupo de activistas, un vecindario — puede construir su propio asistente de IA con el hardware que ya tiene, sin pedir permiso a nadie y sin ceder control de sus datos.

Objetivo

Diseñar e implementar el protocolo FHS: el conjunto de reglas que permite que nodos heterogéneos (modelos LLM locales, herramientas especializadas, agentes autónomos) se descubran, confíen entre sí y cooperen en responder peticiones de usuarios reales, sobre hardware modesto, sin un intermediario central.

Destino

Un teléfono viejo en un cajón se convierte en un Satellite de la red. Una Mac mini de 2014 se convierte en una Star. Una Raspberry Pi con un sensor se convierte en un Satellite con capacidades propias. El chat del vecindario no depende de si OpenAI está de acuerdo — depende de si alguien en la comunidad quiere aportar su hardware.

Ese es el destino: IA distribuida, soberana y comunitaria. galaxIA es la demostración de que es posible.

Cómo se arma la red

Cada nodo se une al swarm P2P, anuncia lo que ofrece en la DHT, y queda disponible para que Navigator lo asigne cuando corresponda:

  flowchart LR
      subgraph "Swarm P2P"
          AT["Atlas\n(bootstrap)"]
          N1["🖥️ Star\nLLM local"]
          N2["💻 Satellite\nOCR / documentos"]
          N3["🍓 Satellite\ntu próxima tool"]
          NAV["Navigator"]
      end
      U["👤 Usuario"] -- "chat" --> W["Portal"]
      W --> NAV
      NAV -->|"GossipSub: offer/bid/assign"| N1
      NAV -->|"stream directo"| N1
      NAV -->|"GossipSub: offer/bid/assign"| N2
      NAV -->|"stream directo"| N2
      AT -.->|"bootstrap"| N1
      AT -.->|"bootstrap"| NAV

No hay un servidor central que controle la red. Navigator descubre recursos disponibles en la DHT y via GossipSub; cada petición declara un ámbito de privacidad (scope) que acota qué providers pueden responder, y cada respuesta trae su propia procedencia auditable. Detalle completo en Cómo funciona el protocolo.

Estrellas y satélites

galaxIA es una galaxia soberana de IA donde equipos reutilizados se convierten en Stars y Satellites. Cada Star aporta razonamiento; cada Satellite aporta una capacidad — OCR, búsqueda, memoria o automatización. El Navigator los descubre en la red P2P y los combina en un agente comunitario.

Súmate

galaxIA crece con cada nodo, cada tool y cada persona que se suma. Si tienes una computadora con capacidad de cómputo, un servicio interno que quieras exponer como herramienta federada, o simplemente ganas de ayudar a construir esto, hay un lugar para ti:

Aportar hardware

Sé un Star (LLM)

Conecta tu modelo local (llama.cpp, Ollama, vLLM) y ponlo a disposición de la comunidad.

Aportar capacidades

Sé un Satellite (tool)

OCR, búsqueda, un servicio interno — expón cualquier capacidad como provider federado.

Aportar código

Contribuye al protocolo

Hay SDKs por escribir en Python, Rust y Go, y features abiertas en el roadmap.

Contacto directo

rafex@rafex.dev

Escribe si tienes preguntas, propuestas o simplemente quieres decir que el proyecto te parece interesante.

Explora el sitio

Protocolo

Qué es FHS, por qué existe, y cómo funciona el ciclo de vida de un nodo y una Mission.

Integrar

Cómo sumar tu propia herramienta/servicio o ser un LLM provider en la red.

Documentación

Referencia técnica: protocolo, Beacons, implementación multi-lenguaje, vocabulario.

Pendientes

Estado actual, TODOs del SDK, y dónde ayudar.

Piezas del ecosistema

galaxIA (este repo)

IDL del protocolo FHS: Protobuf como wire único, AsyncAPI y documentación auxiliar.

galaxIA-Core

Apps: Navigator, Atlas, Portal Chat, Portal TUI, Log Agent y providers de ejemplo.

galaxIA-SDK

Paquetes npm: fhs-protocol, satellite-capabilities, WASM.

galaxIA-satellite-star

Providers de referencia: Star (LLM), Satellite OCR, RAG, KB y Nova (agente).

Empezar

git clone https://github.com/rafex/galaxIA.git
cd galaxIA
# Ver idl/ y docs/ para el protocolo completo
# Para las apps e implementación, ver galaxIA-Core

Documentación del protocolo en Documentación. Implementación de apps en galaxIA-Core. ¿Preguntas? rafex@rafex.dev.