How lnyo-cly/ai4j works
ai4j is a JDK 8+ Java AI-agent SDK, not a single end-user application. A typical request enters an Agent, runs through a selected execution mode, uses model and tool integrations, and returns a result; the SDK also offers distinct RAG ingestion/retrieval, coding-agent, workflow, and long-running harness capabilities. The README supports the capability-level relationships shown here; sampled source confirms details for RAG ingestion/retrieval and FlowGram runtime, but not every integration’s wiring.
Main entry points: ReActRuntime.java Execution modes · Agent.java Agent API · RoutingToolExecutor.java Tool execution · CodingAgentLoopController.java Coding agent
Components 21
Agent runtime
- Agent API
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/Agent.java - Execution modes
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/runtime/ReActRuntime.java - Model clients
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/model/AgentModelClient.java - Tool execution
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/tool/RoutingToolExecutor.java - Agent memory
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/memory/AgentMemory.java - Permission checks
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/permission/AgentPermissionToolExecutor.java - Agent result
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/AgentResult.java
Knowledge and retrieval
- Document ingestion
ai4j/src/main/java/io/github/lnyocly/ai4j/rag/ingestion/IngestionPipeline.java - Embedding services
ai4j/src/main/java/io/github/lnyocly/ai4j/platform/openai/embedding/OpenAiEmbeddingService.java - Vector stores
ai4j/src/main/java/io/github/lnyocly/ai4j/vector/service/PineconeService.java - RAG retrieval
ai4j/src/main/java/io/github/lnyocly/ai4j/rag/DefaultRagService.java
Coding and tasks
- Coding agent
ai4j-coding/src/main/java/io/github/lnyocly/ai4j/coding/loop/CodingAgentLoopController.java - Workspace files
ai4j-coding/src/main/java/io/github/lnyocly/ai4j/coding/workspace/LocalWorkspaceFileService.java - Coding tasks
ai4j-coding/src/main/java/io/github/lnyocly/ai4j/coding/task/CodingTaskManager.java - Long-task harness
ai4j-harness/src/main/java/io/github/lnyocly/ai4j/harness/HarnessTaskSpec.java
Integrations and workflows
- FlowGram API
ai4j-flowgram-spring-boot-starter/src/main/java/io/github/lnyocly/ai4j/flowgram/springboot/controller/FlowGramTaskController.java - FlowGram runtime
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/flowgram/FlowGramRuntimeService.java - A2A protocol
ai4j-agent/src/main/java/io/github/lnyocly/ai4j/agent/a2a/A2AClient.java - MCP server
ai4j/src/main/java/io/github/lnyocly/ai4j/mcp/server/McpServerEngine.java
Other components
- Application caller
- Model providers
Connections 20
- Application caller → Agent API: submits request
README.md - Agent API → Execution modes: runs agent
README.md - Execution modes → Model clients: requests completion
README.md - Model clients → Model providers: calls provider
README.md - Execution modes → Tool execution: dispatches tools
README.md - Execution modes → Agent memory: uses memory
README.md - Tool execution → Permission checks: checks approval
- Execution modes → Agent result: returns result
- Document ingestion → Embedding services: creates embeddings
ai4j/src/main/java/io/github/lnyocly/ai4j/rag/ingestion/IngestionPipeline.java - Document ingestion → Vector stores: upserts vectors
ai4j/src/main/java/io/github/lnyocly/ai4j/rag/ingestion/IngestionPipeline.java - RAG retrieval → Vector stores: retrieves vectors
- Tool execution → RAG retrieval: offers RAG tool
- Application caller → Coding agent: starts coding task
README.md - Coding agent → Workspace files: works on files
README.md - Coding agent → Coding tasks: manages task
- Long-task harness → Coding tasks: governs long tasks
- Application caller → FlowGram API: submits workflow
ai4j-flowgram-spring-boot-starter/src/main/java/io/github/lnyocly/ai4j/flowgram/springboot/controller/FlowGramTaskController.java - FlowGram API → FlowGram runtime: delegates task
- Agent API → A2A protocol: exposes collaboration
README.md - Agent API → MCP server: exposes capabilities
README.md