# agent-dev

**Repository Path**: gooree/agent-dev

## Basic Information

- **Project Name**: agent-dev
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Dev

Agent Dev is an enterprise-grade AI Agent development framework designed specifically for building intelligent conversational assistants and automated task execution systems.

## Project Overview

This framework provides a comprehensive AI Agent development solution, supporting multiple architectural patterns (including ReAct, Plan-and-Execute, Supervisor, etc.), and integrates core functional modules such as the tool system, memory system, skill system, and RAG knowledge base. Through a modular design, developers can flexibly select required components to rapidly build intelligent Agent applications tailored for diverse scenarios.

## Technology Stack

- **Core Framework**: LangChain4j  
- **Communication Protocols**: gRPC, HTTP SSE  
- **Data Storage**: Vector databases, relational databases  
- **Backend Framework**: Spring Boot  
- **Primary Language**: Java  

## Core Features

### Multiple Reasoning Modes

- **ReAct Mode**: Reasoning + Action iterative loop  
- **Plan-and-Execute Mode**: Separation of planning and execution  
- **Supervisor Mode**: Multi-agent collaboration and orchestration  

### Tool System

- MCP tool integration  
- Skill system  
- RAG knowledge retrieval  
- Custom tool extension  

### Memory System

- Short-term memory (sliding window)  
- Long-term memory persistence  
- Dream mechanism for automatic organization  
- Context window compression  

### Communication Architecture

- gRPC dual-channel communication  
- SSE streaming responses  
- OpenAPI-compatible interfaces  

## Module Overview

| Module | Description |
|--------|-------------|
| langchat | Core Agent architecture and foundational capabilities |
| mateclaw | Agent lifecycle and state management |
| ruoyi | Agent interface definitions and development |
| snail | Client-server communication |

## Quick Start

### Maven Dependency

```xml
<dependency>
    <groupId>com.example</groupId>
    <artifactId>agent-dev</artifactId>
    <version>1.0.0</version>
</dependency>
```

### Basic Configuration

```yaml
agent:
  enable: true
  default-model: gpt-4
```

### Create Your First Agent

```java
@Agent(name = "my-agent")
public class MyAgent {
    
    @SystemMessage("You are a helpful assistant...")
    public String chat(String input) {
        return input;
    }
}
```

## Documentation Index

- [langchat Module](./langchat/README-agent.md) - Reference for core Agent functionalities  
- [mateclaw Module](./mateclaw/README.md) - Reference for MateClaw Agent development  
- [ruoyi Module](./ruoyi/01-agent-architecture-overview.md) - Overview of Agent architecture  
- [snail Module](./snail/README.md) - Reference for Snail AI Agent development  

## License

MIT License