Repolode
Enviar
LnYo-Cly

LnYo-Cly/ai4j

SDK para Java 8+ voltado à criação de agentes de IA, com acesso unificado a várias plataformas de LLM, chamada de ferramentas, MCP, RAG e uma CLI/TUI de agente de código integrada.

Ver no GitHubSite
Estrelas
437
Forks
56
Issues abertas
4
Último commit
há 24 dias

O que é?

ai4j é um SDK Java para criar aplicações e agentes baseados em LLM. Ele oferece uma interface de factory para os protocolos Chat, Responses e Messages em provedores como OpenAI, Anthropic, DashScope, Doubao, DeepSeek, Zhipu e Ollama. Para trocar de provedor, basta principalmente alterar o tipo de plataforma e sua configuração. O SDK também oferece chamadas de função, streaming, embeddings e serviços de geração de imagens, áudio e vídeo por meio do mesmo ponto de entrada.

Além do acesso a modelos, o projeto inclui modos de execução de agentes (ReAct, CodeAct e Deep Research), um StateGraph para orquestração, delegação a subagentes e um pipeline de RAG com carregamento e divisão de documentos em chunks, vários adaptadores de vector stores e reranking. Também implementa cliente e servidor MCP via stdio, SSE e Streamable HTTP, além de suporte a A2A. Um starter para Spring Boot disponibiliza um AiService injetável.

O repositório também inclui o ai4j-cli, um agente de código disponível como CLI, TUI ou endpoint ACP para integração com IDEs, que também pode ser incorporado como dependência. Uma SPI de extensões permite que plugins adicionem ferramentas, comandos, skills e prompts, carregados pelo ServiceLoader e ativados explicitamente.

Recursos principais

  • 01Acesso unificado a vários provedores de LLM por meio de uma única factory, com os protocolos Chat, Responses e Messages.
  • 02Execução de agentes nos modos ReAct, CodeAct e Deep Research, com orquestração por StateGraph.
  • 03RAG integrado com análise de documentos, divisão em chunks, vários adaptadores de vector stores e reranking.
  • 04Cliente e servidor MCP via Stdio, SSE e Streamable HTTP, além de colaboração entre agentes com A2A.
  • 05Starter para Spring Boot que injeta AiService com poucas linhas de configuração.
  • 06Agente de código disponível por meio de CLI, TUI e ACP.

Casos de uso

  • Adicionar chat com LLM, embeddings ou geração multimodal a um backend Java ou Spring Boot.
  • Criar sistemas de perguntas e respostas com geração aumentada por recuperação sobre documentos internos usando uma stack Java.
  • Expor sistemas internos como ferramentas para agentes por meio de MCP ou plugins personalizados.
  • Executar um agente de código local pelo terminal ou incorporar um em uma ferramenta Java.

Início rápido

  1. 1

    Adicione a dependência do Maven Central ao seu projeto

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

    Defina sua chave da API da OpenAI como uma variável de ambiente

    export OPENAI_API_KEY=your-api-key
  3. 3

    Crie o primeiro programa de chat com base no exemplo do README e execute-o

Antes de usar

  • O exemplo de 30 segundos requer uma chave da API da OpenAI ou uma plataforma alternativa configurada.

Em coleções

Ferramentas, skills e plugins para Claude CodeAssistentes e agentes de programação com IAServidores MCP

Tópicos

#java#llm-sdk#agent#mcp#rag#function-calling#spring-boot#coding-agent#anthropic#chatglm

Perguntas frequentes

O que é ai4j?
SDK para Java 8+ voltado à criação de agentes de IA, com acesso unificado a várias plataformas de LLM, chamada de ferramentas, MCP, RAG e uma CLI/TUI de agente de código integrada. ai4j é um SDK Java para criar aplicações e agentes baseados em LLM. Ele oferece uma interface de factory para os protocolos Chat, Responses e Messages em provedores como OpenAI, Anthropic, DashScope, Doubao, DeepSeek, Zhipu e Ollama. Para trocar de provedor, basta principalmente alterar o tipo de plataforma e sua configuração. O SDK também oferece chamadas de função, streaming, embeddings e serviços de geração de imagens, áudio e vídeo por meio do mesmo ponto de entrada.
ai4j é gratuito? Qual é a licença?
ai4j é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
ai4j ainda é mantido?
Manutenção ativa. O último commit de ai4j foi em 13 de out. de 2026.
Para que posso usar ai4j?
Adicionar chat com LLM, embeddings ou geração multimodal a um backend Java ou Spring Boot. Criar sistemas de perguntas e respostas com geração aumentada por recuperação sobre documentos internos usando uma stack Java. Expor sistemas internos como ferramentas para agentes por meio de MCP ou plugins personalizados. Executar um agente de código local pelo terminal ou incorporar um em uma ferramenta Java.
Como instalar ai4j?
Adicione a dependência do Maven Central ao seu projeto: implementation 'io.github.lnyo-cly:ai4j:2.8.1' Defina sua chave da API da OpenAI como uma variável de ambiente: export OPENAI_API_KEY=your-api-key Crie o primeiro programa de chat com base no exemplo do README e execute-o
Onde consigo ai4j?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/LnYo-Cly/ai4j

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados