Repolode
LnYo-Cly

LnYo-Cly/ai4j

SDK para Java 8 o superior con el que crear agentes de IA, acceso unificado a varias plataformas LLM, llamadas a herramientas, MCP, RAG y una CLI/TUI de agente de programación integrada.

Estrellas
438
Forks
56
Issues abiertos
4
Último commit
hace 25 días

¿Qué es?

ai4j es un SDK de Java para crear aplicaciones y agentes basados en LLM. Ofrece una interfaz de fábrica única para los protocolos chat, responses y messages en proveedores como OpenAI, Anthropic, DashScope, Doubao, DeepSeek, Zhipu y Ollama. Para cambiar de proveedor, basta principalmente con modificar el tipo de plataforma y su configuración. También ofrece llamadas a funciones, streaming, embeddings y servicios de generación de imágenes, audio y video desde el mismo punto de entrada.

Además del acceso a modelos, el proyecto incluye modos de ejecución de agentes (ReAct, CodeAct y Deep Research), un StateGraph para la orquestación, delegación a subagentes y un pipeline de RAG con carga de documentos, división en fragmentos, varios adaptadores para bases de datos vectoriales y reranking. También implementa un cliente y un servidor MCP a través de stdio, SSE y Streamable HTTP, además de compatibilidad con A2A. Un starter de Spring Boot proporciona un AiService inyectable.

El repositorio también incluye ai4j-cli, un agente de programación disponible como CLI, TUI o endpoint ACP para integrarlo con IDE, y que se puede incorporar como dependencia. Una SPI de extensiones permite que los plugins añadan herramientas, comandos, skills y prompts; se cargan mediante ServiceLoader y deben habilitarse explícitamente.

Funciones clave

  • 01Acceso unificado a muchos proveedores LLM mediante una sola fábrica, con los protocolos Chat, Responses y Messages.
  • 02Ejecución de agentes con los modos ReAct, CodeAct y Deep Research, además de orquestación con StateGraph.
  • 03RAG integrado con análisis de documentos, división en fragmentos, varios adaptadores para bases de datos vectoriales y reranking.
  • 04Cliente y servidor MCP a través de Stdio, SSE y Streamable HTTP, además de colaboración entre agentes mediante A2A.
  • 05Starter de Spring Boot que inyecta AiService con unas pocas líneas de configuración.
  • 06Agente de programación disponible mediante CLI, TUI y ACP.

Casos de uso

  • Añadir chat con LLM, embeddings o generación multimodal a un backend de Java o Spring Boot.
  • Crear sistemas de preguntas y respuestas con generación aumentada por recuperación sobre documentos internos usando una plataforma Java.
  • Exponer sistemas internos como herramientas para agentes mediante MCP o plugins personalizados.
  • Ejecutar un agente de programación local desde la terminal o integrarlo en una herramienta de Java.

Inicio rápido

  1. 1

    Añade la dependencia de Maven Central a tu proyecto

    implementation 'io.github.lnyo-cly:ai4j:2.8.1'
  2. 2

    Configura tu clave de API de OpenAI como variable de entorno

    export OPENAI_API_KEY=your-api-key
  3. 3

    Crea el primer programa de chat a partir del ejemplo del README y ejecútalo

Antes de usarlo

  • El ejemplo de 30 segundos requiere una clave de API de OpenAI o una plataforma alternativa configurada.

En colecciones

Temas

Preguntas frecuentes

¿Qué es ai4j?
SDK para Java 8 o superior con el que crear agentes de IA, acceso unificado a varias plataformas LLM, llamadas a herramientas, MCP, RAG y una CLI/TUI de agente de programación integrada. ai4j es un SDK de Java para crear aplicaciones y agentes basados en LLM. Ofrece una interfaz de fábrica única para los protocolos chat, responses y messages en proveedores como OpenAI, Anthropic, DashScope, Doubao, DeepSeek, Zhipu y Ollama. Para cambiar de proveedor, basta principalmente con modificar el tipo de plataforma y su configuración. También ofrece llamadas a funciones, streaming, embeddings y servicios de generación de imágenes, audio y video desde el mismo punto de entrada.
¿ai4j es gratuito? ¿Qué licencia tiene?
ai4j es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ai4j sigue mantenido?
Mantenimiento activo. El último commit de ai4j fue el 13 oct 2026.
¿Para qué puedo usar ai4j?
Añadir chat con LLM, embeddings o generación multimodal a un backend de Java o Spring Boot. Crear sistemas de preguntas y respuestas con generación aumentada por recuperación sobre documentos internos usando una plataforma Java. Exponer sistemas internos como herramientas para agentes mediante MCP o plugins personalizados. Ejecutar un agente de programación local desde la terminal o integrarlo en una herramienta de Java.
¿Cómo se instala ai4j?
Añade la dependencia de Maven Central a tu proyecto: implementation 'io.github.lnyo-cly:ai4j:2.8.1' Configura tu clave de API de OpenAI como variable de entorno: export OPENAI_API_KEY=your-api-key Crea el primer programa de chat a partir del ejemplo del README y ejecútalo
¿Dónde consigo ai4j?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/LnYo-Cly/ai4j

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados