LnYo-Cly/ai4j
LLM 플랫폼 통합 접근, 도구 호출, MCP, RAG와 코딩 에이전트 CLI/TUI를 제공하는 Java 8+ SDK입니다.
- 스타
- 438
- 포크
- 56
- 열린 이슈
- 4
- 마지막 커밋
- 25일 전
어떤 프로젝트인가요?
ai4j는 LLM 기반 애플리케이션과 에이전트를 구축하기 위한 Java SDK입니다. OpenAI, Anthropic, DashScope, Doubao, DeepSeek, Zhipu, Ollama 등의 제공자를 대상으로 chat, responses, messages 프로토콜을 하나의 팩토리 인터페이스로 제공하며, 주로 플랫폼 유형과 설정을 바꾸는 것만으로 제공자를 전환할 수 있습니다. 함수 호출, 스트리밍, 임베딩, 이미지·오디오·비디오 생성 서비스도 동일한 진입점으로 이용할 수 있습니다.
모델 액세스 외에도 에이전트 실행 모드(ReAct, CodeAct, Deep Research), 오케스트레이션을 위한 StateGraph, 하위 에이전트 위임, 문서 로딩·청킹·여러 벡터 저장소 어댑터·리랭킹을 지원하는 RAG 파이프라인이 포함되어 있습니다. stdio, SSE, Streamable HTTP를 통한 MCP 클라이언트와 서버, A2A도 구현되어 있습니다. Spring Boot starter를 사용하면 AiService를 주입할 수 있습니다.
저장소에는 CLI, TUI 또는 IDE 통합용 ACP 엔드포인트로 사용할 수 있고 의존성으로 임베드할 수도 있는 코딩 에이전트 ai4j-cli도 포함되어 있습니다. 확장 SPI를 통해 플러그인에서 도구, 명령, 스킬, 프롬프트를 추가할 수 있으며, ServiceLoader로 로드한 뒤 명시적으로 활성화합니다.
핵심 기능
- 01하나의 팩토리로 여러 LLM 제공자와 Chat, Responses, Messages 프로토콜에 통합 접근합니다.
- 02ReAct, CodeAct, Deep Research 모드와 StateGraph 오케스트레이션을 지원하는 에이전트 실행 기능입니다.
- 03문서 파싱, 청킹, 여러 벡터 저장소 어댑터, 리랭킹을 포함한 내장 RAG입니다.
- 04Stdio, SSE, Streamable HTTP를 통한 MCP 클라이언트와 서버, A2A 에이전트 협업을 지원합니다.
- 05몇 줄의 설정으로 AiService를 주입하는 Spring Boot starter입니다.
- 06CLI, TUI, ACP 진입점으로 사용할 수 있는 코딩 에이전트입니다.
활용 사례
- Java 또는 Spring Boot 백엔드에 LLM 채팅, 임베딩 또는 멀티모달 생성 기능을 추가합니다.
- Java 스택으로 내부 문서를 대상으로 하는 검색 증강 질의응답을 구축합니다.
- MCP 또는 커스텀 플러그인을 통해 에이전트가 내부 시스템을 도구로 사용하도록 제공합니다.
- 터미널에서 로컬 코딩 에이전트를 실행하거나 Java 도구에 임베드합니다.
빠른 시작
- 1
프로젝트에 Maven Central 의존성을 추가합니다
implementation 'io.github.lnyo-cly:ai4j:2.8.1' - 2
OpenAI API 키를 환경 변수로 설정합니다
export OPENAI_API_KEY=your-api-key - 3
README 예제를 사용해 첫 번째 채팅 프로그램을 만들고 실행합니다
사용 전 알아둘 점
- 30초 예제를 실행하려면 OpenAI API 키 또는 설정된 대체 플랫폼이 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- ai4j은(는) 무엇인가요?
- LLM 플랫폼 통합 접근, 도구 호출, MCP, RAG와 코딩 에이전트 CLI/TUI를 제공하는 Java 8+ SDK입니다. ai4j는 LLM 기반 애플리케이션과 에이전트를 구축하기 위한 Java SDK입니다. OpenAI, Anthropic, DashScope, Doubao, DeepSeek, Zhipu, Ollama 등의 제공자를 대상으로 chat, responses, messages 프로토콜을 하나의 팩토리 인터페이스로 제공하며, 주로 플랫폼 유형과 설정을 바꾸는 것만으로 제공자를 전환할 수 있습니다. 함수 호출, 스트리밍, 임베딩, 이미지·오디오·비디오 생성 서비스도 동일한 진입점으로 이용할 수 있습니다.
- ai4j은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- ai4j은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- ai4j은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. ai4j의 마지막 커밋은 2026년 10월 13일입니다.
- ai4j은(는) 어디에 사용할 수 있나요?
- Java 또는 Spring Boot 백엔드에 LLM 채팅, 임베딩 또는 멀티모달 생성 기능을 추가합니다. Java 스택으로 내부 문서를 대상으로 하는 검색 증강 질의응답을 구축합니다. MCP 또는 커스텀 플러그인을 통해 에이전트가 내부 시스템을 도구로 사용하도록 제공합니다. 터미널에서 로컬 코딩 에이전트를 실행하거나 Java 도구에 임베드합니다.
- ai4j는 어떻게 설치하나요?
- 프로젝트에 Maven Central 의존성을 추가합니다: implementation 'io.github.lnyo-cly:ai4j:2.8.1' OpenAI API 키를 환경 변수로 설정합니다: export OPENAI_API_KEY=your-api-key README 예제를 사용해 첫 번째 채팅 프로그램을 만들고 실행합니다
- ai4j은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/LnYo-Cly/ai4j
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Java, LangChain4j, Spring Boot, Vue 3 기반의 오픈소스 AI 에이전트 애플리케이션 플랫폼으로, 모델, 에이전트, RAG, Skills, MCP, text-to-SQL 분석을 지원합니다.
지원되는 LLM(OpenAI, Anthropic, Ollama, LMStudio)이 자연어로 하나 이상의 MCP 서버 도구를 호출할 수 있게 해주는 Python 라이브러리 및 CLI입니다.
상태를 유지하는 LLM 에이전트를 만들기 위한 TypeScript 기반 오픈소스 에이전트 하네스로, 코딩 에이전트, CLI, Web UI, SDK를 제공합니다.
AI Agent 설계 원칙과 엔지니어링 실무를 다루는 무료 오픈소스 중국어 도서와 109개 실습
채팅, 함수 호출, 구조화된 JSON 출력, 임베딩, Spring Boot 스타터를 지원하는 DeepSeek API용 Java SDK입니다.