Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

llm-ferry

Gateway AI auto-hospedado para Mac que expone un único endpoint OpenAI-compatible a toda la LAN. Combina inferencia local MLX en Apple Silicon con proxies de nube, gestionando suscripciones OAuth y fallbacks automáticos sin exponer claves.

Ficha actualizada 24 sept 2026, 0:19 · upstream 23 sept 2026, 23:56 · release v1.37.0

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es llm-ferry

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

llm-ferry actúa como puerta de entrada artificial para redes locales, permitiendo a múltiples clientes acceder a modelos de IA desde un único host Mac. Centraliza la gestión de suscripciones de proveedores como OpenAI o Anthropic mediante OAuth, asegurando que las claves nunca abandonen el servidor principal. El sistema soporta tanto inferencia local optimizada con MLX en hardware Apple Silicon como proxy de servicios en la nube, configurando rutas de fallback automáticas para mantener la disponibilidad.

Incluye Signal Studio, una interfaz visual para diseñar cadenas de modelos y monitorizar tráfico en tiempo real. Además, facilita la transferencia de archivos o modelos completos entre dispositivos mediante su propia red, y permite túneles inversos para clientes con restricciones de salida. Es ideal para laboratorios domésticos o equipos pequeños que buscan optimizar costes y centralizar seguridad.

La arquitectura se basa en Python estándar y zsh sin dependencias pesadas como Docker, lo que reduce la huella del host pero exige gestión manual de actualizaciones. El despliegue requiere un Mac potente con GPU integrada para aprovechar las capacidades de MLX, mientras que los clientes pueden ser cualquier dispositivo compatible con HTTP.

CASOS DE USO
  • Centralizar suscripciones de API (OpenAI/Claude) para toda la red local sin exponer claves en cada cliente.
  • Servir modelos locales optimizados con MLX a clientes ligeros sin instalarlos en ellos.
  • Configurar cadenas de fallback automáticos entre modelos costosos y económicos según disponibilidad.
  • Transferir modelos o archivos grandes entre dispositivos LAN utilizando el host como punto de transferencia.
  • Proporcionar acceso remoto seguro vía túnel inverso para clientes bloqueados por políticas de red.
PUNTOS DESTACADOS
  • Endpoint único OpenAI-compatible que unifica inferencia local y nube en una sola URL.
  • Gestión segura de suscripciones OAuth (Claude/ChatGPT) donde las claves residen exclusivamente en el host.
  • Inferencia nativa en Apple Silicon con MLX, optimizando memoria GPU y velocidad de decodificación.
  • Interfaz Signal Studio para gestión visual de rutas, fallbacks y monitorización de latencia.
  • Capacidad de ferryizar modelos y archivos entre dispositivos LAN sin depender de almacenamiento externo.
PRECAUCIONES
  • Requiere hardware Apple Silicon (M1/M2/M3) para activar la inferencia local vía MLX.
  • No utiliza contenedores Docker, necesitando instalación manual del CLI en el host.
  • El tráfico cliente-host se realiza sobre HTTP plano en la red local, requiriendo seguridad perimetral adecuada.
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Signal Studio desktop: searchable model library, editable fallback routes, and route overviewSignal Studio on phone: tap to edit a route from anywhere on the LANllm-ferry terminal workflow demoSignal Studio on iPad: drag fallback hops between ordered chainsLive request stream: per-request first-text latency, token counts, throughput, and the fallback hop each request walked
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA8 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Despliegue inicial mediante `host-bootstrap.sh` para instalar dependencias y descargar modelos. Configurar variables de entorno (ej. OPENROUTER_API_KEY) o usar `ferry auth-claude login`. Ejecutar `ferry up` para seleccionar modelos y `ferry share` para obtener la URL de acceso LAN. Los clientes instalan el CLI vía curl y se conectan al endpoint compartido.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsNode.jsPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
809142908090
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.