ARGI

Stateful agent runtime for Java applications.

Graph workflows · ReAct agents · Context engineering · Human-in-the-loop · Multi-agent orchestration

Documentation · Quick Start · Examples · 简体中文

ARGI stands for Agent Runtime and Graph Intelligence and is pronounced "AR-jee" (/ˈɑːr.dʒiː/). It is a framework for Java developers building agents, workflows, and multi-agent applications. Forked from Spring AI Alibaba, it provides context engineering, human-in-the-loop, graph workflows, and distributed Agent-to-Agent (A2A) collaboration.

Features

• Agent orchestration: ReactAgent, SequentialAgent, ParallelAgent, RoutingAgent, and LoopAgent.
• Context engineering: context compaction and editing, call limits, tool retries, planning, and dynamic tool selection.
• Graph workflows: conditional routing, parallel execution, nested graphs, state persistence, and interruption recovery.
• Agent runtime foundation: provider-neutral agent orchestration, workflow state, and embeddable debugging support.
• Open integrations: a neutral ChatClient with Spring AI, LangChain4j, Google ADK, and AgentScope adapters, plus tool calling, MCP, A2A, and Nacos.
• Visual debugging: an embeddable Agent Chat UI for Spring Boot applications.

Quick Start

Requirements: JDK 17 or later and Maven 3.9.1 or later. Build the framework with its Maven Wrapper and run the standalone examples with your local Maven installation.

git clone --depth=1 https://github.com/agentic-ai-java/argi.git
cd argi

# Install the local development modules.
./mvnw -DskipTests install

# Configure any supported model provider and run the chatbot example.
cd ..
git clone --depth=1 https://github.com/agentic-ai-java/argi-examples.git
cd argi-examples
mvn -f examples/chatbot/pom.xml spring-boot:run

The examples also require the matching Extensions BOM and provider starters. See the example setup. Examples using older Spring AI agent builders require the direct-replacement migration described in API and Adapters; that external repository is not migrated by this change.

Open http://localhost:8080/chatui/index.html. See the Quick Start for other model providers.

Modules

Documentation

• Overview
• Quick Start
• Agent Framework tutorials
• Graph Core Quick Start
• Examples
• Provider-specific examples

Contributing

Read the contribution guide before submitting changes. Report problems and suggestions through GitHub Issues.

License

ARGI is available under the Apache License 2.0.